curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "Ein wunderschöner bunter Sonnenuntergang über dem Ozean"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "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": 2.5,
    "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: minimax-h3-image",
    "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"
  }
}

Minimax

MiniMax H3 Image Bildgenerierung

MiniMax H3 Image (minimax-h3-image) unterstützt Text-zu-Bild-Generierung und Bildbearbeitung mit bis zu 16 Referenzbildern
Ausgabe mit bis zu 20 Millionen Pixeln: Seitenverhältnis mit einer Auflösungsstufe von 1K / 2K / 4K kombinieren oder Breite und Höhe in Pixeln angeben
Asynchrone Verarbeitung: Mit der zurückgegebenen Aufgaben-ID die Aufgabe abfragen
Links zu generierten Bildern sind 24 Stunden gültig. Speichern Sie die Ergebnisse rechtzeitig

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": "minimax-h3-image",
  "prompt": "Ein wunderschöner bunter Sonnenuntergang über dem Ozean"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "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": 2.5,
    "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: minimax-h3-image",
    "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>

Standard:minimax-h3-image

erforderlich

Name des Bildgenerierungsmodells. Der offizielle Kanal bietet bessere Stabilität und Kontrolle für den kommerziellen Einsatz

Verfügbare Optionen:

minimax-h3-image

Beispiel:

"minimax-h3-image"

prompt

string

erforderlich

Prompt, der das zu generierende Bild oder die Bearbeitung der Eingabebilder beschreibt

Längenbeschränkungen:

Bis zu 32,000 Zeichen (gezählt als Unicode-Codepunkte)
Wenn prompt_extend auf false gesetzt ist, werden nur ungefähr die ersten 4096 Token des Prompts berücksichtigt

Maximum string length: 32000

Beispiel:

"Ein wunderschöner bunter Sonnenuntergang über dem Ozean"

image_urls

string<uri>[]

Liste der Referenzbild-URLs für Bild-zu-Bild-Generierung und Bildbearbeitung

Hinweise:

Anzahl der Eingabebilder pro Anfrage: 1~16
Maximale Dateigröße pro Bild: 64MB
Breite und Höhe jedes Bildes: 128 bis 8192 px
Seitenverhältnis jedes Bildes: längste Seite / kürzeste Seite höchstens 4:1
Unterstützte Formate: .jpeg, .jpg, .png, .webp, .heic, .heif
Bild-URLs müssen für den Server direkt zugänglich sein oder einen direkten Download auslösen (solche URLs enden meist mit einer Bilddateiendung wie .png oder .jpg)
Referenzbilder verursachen bei Bild-zu-Bild-Generierung und Bildbearbeitung zusätzliche Bild-Eingabetoken

Beispiel:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

size

string

Standard:auto

Größe des Ausgabebildes. Unterstützt Seitenverhältnisse und explizite Pixelmaße. Standard: auto

① Seitenverhältnis (empfohlen): X:Y. Übliche Verhältnisse:

1:1: quadratisch
1:2 / 2:1: hoch / breit
1:3 / 3:1: besonders hoch / besonders breit (an der Grenze von 3:1)
2:3 / 3:2: übliches Hoch- / Querformat
3:4 / 4:3: traditionelles Hoch- / Querformat
4:5 / 5:4: gängige Social-Media-Formate
9:16 / 16:9: Smartphone- / Desktop-Breitbild
9:21 / 21:9: Ultrabreitformate

Andere X:Y-Werte werden ebenfalls unterstützt: X und Y müssen ganze Zahlen von 1 bis 300 sein, bei einem Seitenverhältnis ≤ 3:1

② Explizite Pixelmaße: WxH (oder W×H), z. B. 1024x1024, 2720x1536, 5472x3072

Pixelbudget: 655,360 ≤ width × height ≤ 20,000,000 (ungefähr 0,65 MP bis 20 MP)
Seitenverhältnis: ≤ 3:1

③ auto: Das Modell wählt das Seitenverhältnis automatisch; die Ausgabefläche richtet sich weiterhin nach der Stufe resolution

Überschreitung der Grenzen:

Größen außerhalb dieser Grenzen geben 400 zurück und werden nicht automatisch skaliert oder gerundet

Beispiel:

"auto"

resolution

enum<string>

Standard:2K

Kurzparameter für die Auflösungsstufe. Gilt bei size = auto oder einem Seitenverhältnis; wird bei expliziten Pixelmaßen ignoriert

Pixelbudget (Breite und Höhe werden aus der Gesamtpixelzahl und dem Seitenverhältnis size berechnet):

1K: ~1 MP (1024² = 1,048,576 Pixel)
2K: ~4 MP (2048² = 4,194,304 Pixel)
4K: ~16,8 MP (4096² = 16,777,216 Pixel)

Tatsächliche Ausgabegrößen im Querformat / Quadrat (für das Hochformat werden Breite und Höhe vertauscht; z. B. entspricht 3:4 dem umgekehrten 4:3):

Seitenverhältnis	2K	4K
`1:1`	2048×2048	4096×4096
`4:3`	2368×1760	4736×3552
`16:9`	2720×1536	5472×3072
`3:1`	3552×1184	7104×2368

Hinweise:

1K und 2K verbrauchen gleich viele Bild-Ausgabetoken (ungefähr 4,096 pro Bild); 4K verbraucht ungefähr 16,384 pro Bild. Maßgeblich ist der zurückgegebene Wert usage
Groß- und Kleinschreibung wird nicht unterschieden

Verfügbare Optionen:

1K,

2K,

4K

Beispiel:

"2K"

output_format

enum<string>

Standard:jpeg

Dateiformat des Ausgabebildes. Standard: jpeg

jpeg: verlustbehaftete Komprimierung, kleinere Dateien
png: verlustfrei
webp: ausgewogenes Verhältnis zwischen Dateigröße und Qualität

Hinweis:

Transparente Hintergründe werden nicht unterstützt

Verfügbare Optionen:

jpeg,

png,

webp

Beispiel:

"jpeg"

integer

Standard:1

Anzahl der zu generierenden Bilder. Jedes Bild wird separat abgerechnet

Hinweise:

Text-Eingabetoken und Bild-Eingabetoken steigen proportional mit n
Wenn einzelne Bilder fehlschlagen (z. B. bei der Inhaltsprüfung), wird die Aufgabe mit den erfolgreichen Bildern abgeschlossen. Die tatsächliche Anzahl ergibt sich aus results in der Antwort; die Abrechnung richtet sich nach dem zurückgegebenen usage

Erforderlicher Bereich: 1 <= x <= 10

Beispiel:

1

prompt_extend

boolean

Standard:true

Prompt-Optimierung: Das Modell formuliert den Prompt vor der Generierung ausführlicher. Standard: true

Hinweise:

Kann nur bei Text-zu-Bild-Generierung auf false gesetzt werden, wenn size ein Seitenverhältnis oder explizite Pixelmaße enthält
Bei size = auto oder angegebenen image_urls führt false zu 400
Wenn aktiviert, werden ungefähr 2,300 bis 3,800 zusätzliche Text-Eingabetoken pro Bild benötigt; andernfalls wird nur der ursprüngliche Prompt gezählt

Beispiel:

true

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:

"minimax-h3-image"

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

MiniMax H3 Image Bildgenerierung

Autorisierungen

Body

Antwort