> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Imagine Image 2.0 – offizielle Generierung und Bearbeitung

> Asynchrone Bildgenerierung und -bearbeitung mit grok-imagine-image-2.0

<Info>
  Dies ist ein **asynchroner Endpunkt**. Nach erfolgreicher Übermittlung wird eine Task-ID zurückgegeben. Fragen Sie den [Task-Status](/de/api-reference/tasks/status) für das Endergebnis ab. Ohne `image_urls` erfolgt Text-zu-Bild; mit Referenzen Bildbearbeitung oder Mehrbildreferenz.
</Info>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.apimart.ai/v1/images/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --header 'X-APIMart-Response-Version: 2026-07-27' \
    --data '{
      "model": "grok-imagine-image-2.0",
      "prompt": "Eine filmische, neonbeleuchtete Stadtstraße in einer regnerischen Nacht",
      "n": 1,
      "aspect_ratio": "16:9",
      "resolution": "2k",
      "quality": "medium"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "code": 202,
    "data": {
      "id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
      "object": "generation.task",
      "type": "image",
      "status": "pending",
      "progress": 0,
      "poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
    }
  }
  ```
</ResponseExample>

## Modellfunktionen

| Modell                   | Auflösung  | `quality`                         | Eingabebilder | Ausgaben |
| ------------------------ | ---------- | --------------------------------- | ------------: | -------: |
| `grok-imagine-image-2.0` | `1k`, `2k` | Nur Text-zu-Bild: `low`, `medium` |           0–3 |     1–10 |

## Body

<ParamField body="model" type="string" default="grok-imagine-image-2.0" required>Fester Wert: `grok-imagine-image-2.0`.</ParamField>
<ParamField body="prompt" type="string" required>Anweisung zur Generierung oder Bearbeitung. Nach dem Trimmen nicht leer, maximal 8.000 Zeichen.</ParamField>
<ParamField body="n" type="integer" default="1">Anzahl der Ausgaben: `1`–`10`.</ParamField>
<ParamField body="aspect_ratio" type="string" default="auto">Unterstützt `1:1`, `3:4`, `4:3`, `9:16`, `16:9`, `2:3`, `3:2`, `9:19.5`, `19.5:9`, `9:20`, `20:9`, `1:2`, `2:1`, `auto`.</ParamField>
<ParamField body="resolution" type="string" default="1k">`1k` oder `2k`.</ParamField>
<ParamField body="quality" type="string">Nur Text-zu-Bild: `low` oder `medium` (Standard). Nicht zusammen mit `image_urls` senden.</ParamField>
<ParamField body="image_urls" type="array">Ein bis drei Referenzbilder als öffentliche HTTP(S)-URL oder JPEG-, PNG-, WebP-Base64-Data-URL.</ParamField>

## Asynchroner Task

Eine erfolgreiche Übermittlung liefert HTTP `202`; die Task-ID steht in `data.id`. Verwenden Sie `data.poll_url` oder `GET /v1/tasks/{task_id}` bis `completed` oder `failed`.