curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image-2.0",
  "prompt": "Cyberpunk-Straßenszene in Tokio bei Nacht, Neonlichter spiegeln sich auf dem nassen Asphalt"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.06,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: grok-imagine-image-2.0",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Grok

Grok Imagine Image 2.0 Bildgenerierung

Grok Imagine Image 2.0 (grok-imagine-image-2.0) ist das Bildgenerierungs- und Bildbearbeitungsmodell von xAI — Text-zu-Bild und Bildbearbeitung teilen sich denselben Modellnamen
Ohne image_urls = Text-zu-Bild; mit 1~3 Referenzbildern wechselt das Modell automatisch in den Bildbearbeitungsmodus, ohne Modellwechsel
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image-2.0",
  "prompt": "Cyberpunk-Straßenszene in Tokio bei Nacht, Neonlichter spiegeln sich auf dem nassen Asphalt"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.06,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: grok-imagine-image-2.0",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

erforderlich

Name des Bildgenerierungsmodells. Text-zu-Bild und Bildbearbeitung nutzen denselben Modellnamen; der Modus wird automatisch danach umgeschaltet, ob image_urls übergeben wird

Verfügbare Optionen:

grok-imagine-image-2.0

Beispiel:

"grok-imagine-image-2.0"

prompt

string

erforderlich

Prompt, der das gewünschte Bild beschreibt oder wie die übergebenen Referenzbilder bearbeitet werden sollen

Syntax für Mehrbild-Referenzen:

Bei mehreren Referenzbildern können Sie im Prompt mit <IMAGE_0>, <IMAGE_1>, <IMAGE_2> das 1., 2. bzw. 3. Referenzbild ansprechen
Die Indizes beginnen bei 0 und entsprechen eins zu eins der Reihenfolge im Array image_urls
Beispiel: Setze die Person aus <IMAGE_0> in die Szene von <IMAGE_1>

Beispiel:

"Cyberpunk-Straßenszene in Tokio bei Nacht, Neonlichter spiegeln sich auf dem nassen Asphalt"

image_urls

string<uri>[]

Referenzbild-URL-Liste für Bild-zu-Bild- und Bildbearbeitungsfunktionen

Hinweis:

Anzahl der Eingabebilder pro Anfrage: 0~3 (ohne Angabe = Text-zu-Bild, 1~3 = Bildbearbeitung)
Es werden ausschließlich öffentlich erreichbare http / https Bild-URLs unterstützt; base64 und data-URLs werden nicht unterstützt
Unterstützte Dateiformate: .jpeg, .jpg, .png, .webp
Bild-URLs müssen direkt vom Server abrufbar sein oder die Bild-URL sollte beim Zugriff direkt heruntergeladen werden (typischerweise enden diese URLs mit Bilddateiendungen wie .png, .jpg)
Bei der Bildbearbeitung verursachen die übergebenen Referenzbilder zusätzliche Kosten, die pro Anfrage nur einmal anfallen und sich nicht mit n vervielfachen

Maximum array length: 3

Beispiel:

[
  "https://example.com/person.png",
  "https://example.com/scene.png"
]

size

enum<string>

Standard:auto

Seitenverhältnis des generierten Bildes, Standard auto

Unterstützte Seitenverhältnisse (13):

Verhältnis	Beschreibung
`1:1`	Quadratisch
`4:3` / `3:4`	Klassisch quer / hoch
`3:2` / `2:3`	Standard quer / hoch
`16:9` / `9:16`	Breitbild / Smartphone-Hochformat
`2:1` / `1:2`	Extrem breit / extrem hoch
`19.5:9` / `9:19.5`	Full-Screen-Smartphone quer / hoch
`20:9` / `9:20`	Ultrabreit quer / hoch

Hinweis:

auto: Das Modell bestimmt das Verhältnis selbst; wird der Parameter weggelassen, entspricht das auto (die Ausgabe ist meist im Hochformat)
Werte außerhalb der obigen Tabelle werden nicht unterstützt

Verfügbare Optionen:

1:1,

4:3,

3:4,

3:2,

2:3,

16:9,

9:16,

2:1,

1:2,

19.5:9,

9:19.5,

20:9,

9:20,

auto

Beispiel:

"16:9"

resolution

enum<string>

Standard:1K

Pixelstufe des Ausgabebildes, Standard 1K; unterstützt die Stufen 1K und 2K

Hinweis:

Dieses Modell unterstützt kein 4K
Werte sind nicht case-sensitiv

Verfügbare Optionen:

1K,

2K

Beispiel:

"1K"

quality

enum<string>

Standard:medium

Qualitätsstufe der Generierung, steuert die Denktiefe des Modells, Standard medium

Wert	Beschreibung
`low`	Schnellere Ausgabe, geringere Kosten
`medium`	Bessere Bildqualität und Details

Hinweis:

Dieses Modell unterstützt nur die Stufen low / medium; andere Werte wie high werden nicht unterstützt
quality (Qualitätsstufe) und resolution (Pixelstufe) sind unabhängig voneinander und frei kombinierbar
Werte sind nicht case-sensitiv

Verfügbare Optionen:

low,

medium

Beispiel:

"medium"

integer

Standard:1

Anzahl der zu generierenden Bilder, Bereich 1~10, Standard 1

Hinweis:

Jedes Bild wird separat abgerechnet, die Kosten steigen linear mit n
Die Zusatzkosten für Referenzbilder fallen pro Anfrage nur einmal an und vervielfachen sich nicht mit n
Nach Abschluss der Aufgabe liefert result_urls n voneinander unabhängige Bildlinks

Erforderlicher Bereich: 1 <= x <= 10

Beispiel:

1

callback_url

string<uri>

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

Nur HTTPS-Protokoll wird unterstützt
Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus

Beispiel:

"https://your-domain.com/webhooks/image-task-completed"

Antwort

Bildaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757156493

string

Aufgaben-ID

Beispiel:

"task-unified-1757156493-imcg5zqt"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"grok-imagine-image-2.0"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

image.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Asynchrone Aufgabeninformationen

Show child attributes

type

enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"image"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Grok Imagine Image 2.0 Bildgenerierung

Autorisierungen

Body

Antwort