curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "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: mj-v8.2",
    "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"
  }
}

Midjourney V8.2

Midjourney V8.2 Bildgenerierung

Das Midjourney V8.2 Modell unterstützt die Generierung hochwertiger Bilder per natürlichsprachigem Prompt. Der Fast-Modus liefert 4 Bilder pro Generierung; der Draft-Modus liefert 24 leichtgewichtige 512-px-Skizzenbilder in einem einzigen Durchlauf
Unterstützt Text-zu-Bild und Bild-zu-Bild (Bild-URLs im Prompt referenzieren)
Eingabebild-URLs müssen öffentlich erreichbar und innerhalb von etwa 10 Sekunden abrufbar sein; der Upstream lädt Bilder beim Erstellen der Aufgabe synchron und gibt 400 zurück, wenn dies nicht gelingt. Bild-Hoster außerhalb Festlandchinas (imgur, ibb, raw.githubusercontent, pinimg, picsum) schlagen in der Praxis fehl. Hosten Sie Bilder auf einem schnellen CDN oder nutzen Sie den Datei-Upload der Plattform
V8.2-Highlights: Ästhetik- und Bildqualitäts-Upgrade gegenüber V8.1, eine Detailstufe, die über das native Parameter --quality / --q (1–4, 4 = Hochqualitätsmodus) im Prompt gesetzt wird (ohne Aufpreis), und native 2K-Ausgabe (quality=hd). Turbo ist auf V8.2 nicht verfügbar (der Upstream dokumentiert V8 als ohne Turbo-Unterstützung)
Stilreferenz (--sref) wird unterstützt; --oref / --cref werden auf V8.2 nicht unterstützt und vom Upstream abgelehnt, siehe Prompt-Parameter-Handbuch
Vom Upstream nicht unterstützte Prompt-Parameters werden unverändert durchgereicht: Die Aufgabe schlägt mit einem Parameterfehler (invalid_parameters) fehl und reservierte Credits werden erstattet (sie werden nicht mehr stillschweigend verworfen)
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum Abfragen des Status
Generierte Bildlinks sind 30 Tage gültig, bitte zeitnah speichern
Timeout: ca. 20 Minuten
Parameterhinweis: Diese Route läuft auf V8.2 und unterstützt kein niji; legen Sie den Geschwindigkeitsmodus über model_params.speed und die Ausgabequalität über den Top-Level-Parameter quality fest; die Detailstufe wird als --quality / --q (1–4) in den Prompt geschrieben und unverändert durchgereicht
mj-v8.2-edit / mj-v8.2-upload-paint sind Canvas-Bearbeitungen (img_pos + Maske). Der anweisungsbasierte Bearbeitungs-Endpunkt des Upstreams (--edit, bis zu 4 Referenzbilder) ist auf dieser Route noch nicht verfügbar und wird derzeit eingeplant

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": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "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: mj-v8.2",
    "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"
  }
}

Midjourney verfügt über ein integriertes Moderationssystem. Jedes Bild wird einzeln geprüft: Gefilterte Bilder erscheinen nicht in den Ergebnissen, die übrigen Bilder werden normal geliefert, sodass Sie weniger Bilder als üblich erhalten können. Besteht mindestens ein Bild die Prüfung, ist die Aufgabe completed und wird normal abgerechnet; werden alle Bilder gefiltert, endet die Aufgabe als failed und die reservierten Credits werden vollständig erstattet. Bitte achten Sie darauf, dass Ihre Prompts und Referenzbilder den Inhaltsrichtlinien entsprechen.

Autorisierungen

Authorization

string

header

erforderlich

Alle Endpunkte erfordern Bearer Token Authentifizierung

API Key erhalten:

Besuchen Sie die API Key Verwaltungsseite um Ihren API Key zu erhalten

Zum Request-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:mj-v8.2

erforderlich

Modellname

Verfügbare Optionen:

mj-v8.2

prompt

string

erforderlich

Prompt, unterstützt die gesamte native Parametersyntax von Midjourney V8.2 (z.B. --ar 16:9 --s 500).

Bild-zu-Bild: Platzieren Sie Bild-URLs am Anfang des Prompts. Unterstützte Formate: .png, .gif, .webp, .jpg, .jpeg

Bild-zu-Bild-Regeln:

1 Bild + kein Text = ungültig (gibt Fehler zurück)
1 Bild + Textbeschreibung = gültig
2+ Bilder + kein Text = gültig
2+ Bilder + Textbeschreibung = gültig

Nicht unterstützte Parameter: Parameter, die der Upstream nicht unterstützt (z. B. --oref, --cref, --stop, --bs), werden durchgereicht und vom Upstream ausdrücklich abgelehnt: Die Aufgabe schlägt mit einem Parameterfehler (invalid_parameters) fehl und reservierte Credits werden erstattet. --v / --version / --niji sowie die Geschwindigkeits-/hd-Parameter werden entfernt und über API-Parameter gesteuert; --quality / --q (1–4) wird durchgereicht.

Maximum string length: 2048

Beispiel:

"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"

quality

enum<string>

Standard:standard

Ausgabequalität

standard: Standardauflösung (Standard), 1x Multiplikator
hd: Native HD-Ausgabe, 1,5x Multiplikator. Schließt sich mit speed: draft gegenseitig aus

Preishinweis: Der Qualitätsmultiplikator wird mit dem speed-Multiplikator kombiniert (multipliziert).

Verfügbare Optionen:

standard,

hd

model_params

object

Modellparameter

Show child attributes

callback_url

string<uri>

HTTPS-Callback-URL für Aufgabenabschluss

Callback-Zeitpunkt:

Ausgelöst bei Abschluss, Fehler oder Abbruch der Aufgabe
Nach Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

Nur HTTPS-Protokoll
Callbacks an private IP-Adressen 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
Bis zu 3 Wiederholungen nach Fehler (Wiederholungen nach 1s/2s/4s nach Fehler)
Das Format des Callback-Antwortkörpers entspricht dem Aufgabenabfrage-Endpunkt
Ein 2xx-Statuscode gilt als erfolgreich; andere Statuscodes lösen Wiederholungen aus

Beispiel:

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

Antwort

Aufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757165031

string

Aufgaben-ID

Beispiel:

"task-unified-1757165031-mjv82"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"mj-v8.2"

object

enum<string>

Aufgabenobjekttyp

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 Aufgabeninformation

Show child attributes

type

enum<string>

Aufgabenausgabetyp

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"image"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Midjourney V8.2 Bildgenerierung

Autorisierungen

Alle Endpunkte erfordern Bearer Token Authentifizierung

Body

Antwort