guide
Midjourney V8.1 API mit EvoLink nutzen: Payload, Polling und Callback
EvoLink Team
Product Team
21. Juni 2026
5 Min. Lesezeit
Wenn Sie Midjourney V8.1 aus Code nutzen wollen, ist die wichtigste Frage nicht nur der Endpoint. Entscheidend ist, wie Sie Tasks erstellen, den Status verfolgen, Kosten kontrollieren und später andere Bildmodelle über dieselbe EvoLink Integration testen können.
Auf EvoLink verwenden Sie für die Hauptgenerierung
POST https://api.evolink.ai/v1/images/generations mit model: "mj-v8.1". Die Antwort ist ein asynchroner Task. Den Status prüfen Sie über GET https://api.evolink.ai/v1/tasks/{task_id} oder über callback_url.Kurzantwort
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "mj-v8.1",
"prompt": "a premium product photo of a matte black espresso machine on a marble counter --ar 16:9 --s 250",
"quality": "standard",
"model_params": {
"speed": "fast"
},
"callback_url": "https://your-domain.com/webhooks/evolink-image-task"
}'Speichern Sie die zurückgegebene
id. Sie ist die task_id für Polling, Callback-Abgleich und Fehleranalyse.curl --request GET \
--url https://api.evolink.ai/v1/tasks/<task_id> \
--header 'Authorization: Bearer YOUR_API_KEY'Bestätigte Fakten für EvoLink
| Thema | Aktueller Stand |
|---|---|
| Endpoint | POST /v1/images/generations |
| Modellname | mj-v8.1 |
| Auth | Authorization: Bearer YOUR_API_KEY |
| Pflichtfelder | model, prompt |
| Qualität | Top-level-quality: standard oder hd |
| Geschwindigkeit | model_params.speed: draft, fast |
| Async Status | GET /v1/tasks/{task_id} |
| Output | Fast bis zu 4 Bilder; Draft bis zu 24 leichte 0.5K Skizzen |
| Link-Laufzeit | Generierte Bildlinks sind 30 Tage gültig |
Request-Felder
| Feld | Pflicht | Beispiel | Hinweis |
|---|---|---|---|
model | Ja | mj-v8.1 | Wählt die Midjourney V8.1 Route |
prompt | Ja | a product photo... --ar 16:9 | Text plus unterstützte MJ Prompt-Parameter |
quality | Nein | standard, hd | hd hat einen 1.5x Qualitätsmultiplikator |
model_params.speed | Nein | draft, fast | draft und hd sind gegenseitig ausgeschlossen |
callback_url | Nein | https://... | HTTPS-Callback für finale Task-Events |
Schreiben Sie
quality nicht in model_params. Auf dieser EvoLink Route ist quality ein Top-level-Feld.Text-zu-Bild und Bild-zu-Bild
Für Text-zu-Bild reicht ein Prompt:
{
"model": "mj-v8.1",
"prompt": "a cinematic product photo of a titanium travel mug on wet black stone --ar 16:9 --s 250",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}Für Bild-zu-Bild setzen Sie Bild-URLs an den Anfang des Prompts. Unterstützte Formate sind PNG, GIF, WebP, JPG und JPEG. Eine einzelne Bild-URL ohne Text ist ungültig; nutzen Sie ein Bild plus Text, mehrere Bilder oder mehrere Bilder plus Text.
{
"model": "mj-v8.1",
"prompt": "https://your-cdn.example.com/reference-sofa.jpg a luxury living room campaign image --ar 4:3 --iw 1.2",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}Callback in Produktion
callback_url muss HTTPS verwenden, darf maximal 2048 Zeichen lang sein und darf nicht auf private IP-Bereiche wie 127.0.0.1, 10.x.x.x, 172.16-31.x.x oder 192.168.x.x zeigen. EvoLink sendet den Callback bei abgeschlossenen, fehlgeschlagenen oder abgebrochenen Tasks. Timeout: 10 Sekunden, bis zu 3 Wiederholungen.Ein produktiver Handler sollte schnell
2xx antworten, den Task per GET /v1/tasks/{task_id} final prüfen, wiederholte Callbacks deduplizieren und Ergebnisse vor Ablauf der 30 Tage in den eigenen Storage kopieren.Kosten- und Routing-Hinweise
| Wahl | Auswirkung | Empfehlung |
|---|---|---|
fast | Standard-Geschwindigkeit | Gute Standardoption für Produkt-Workflows |
draft | Leichte Skizzen, nicht mit hd kombinieren | Gut für frühe Kompositionssuche |
standard | Basisqualität | Vorschau und normale App-Ausgaben |
hd | 1.5x Qualitätsmultiplikator | Finale Assets und hochwertige Kampagnen |
Der Vorteil auf EvoLink liegt nicht nur in Midjourney V8.1 selbst. Teams können die gleiche Authentifizierung, Task-Logik und Abrechnung nutzen, um später andere Bildrouten wie Midjourney V7, Nano Banana Pro oder GPT Image 2 zu testen.
Produktions-Checklist
| Bereich | Erwartetes Verhalten |
|---|---|
| API Key | Nur serverseitig speichern |
| Logging | Modell, Prompt-Hash, quality, model_params.speed, Nutzer-ID und task_id loggen |
| UI | pending, processing, completed, failed anzeigen |
| Polling | Erst kurz, dann mit Backoff prüfen |
| Callback | Schnell 2xx antworten und async weiterverarbeiten |
| Storage | Bilder vor Ablauf der 30 Tage sichern |
| Kostenkontrolle | hd bewusst freischalten |
FAQ
Welchen Endpoint nutze ich für Midjourney V8.1 auf EvoLink?
Nutzen Sie
POST /v1/images/generations zum Erstellen des Tasks und GET /v1/tasks/{task_id} für den Status.Welcher Modellname ist korrekt?
Für die Hauptgenerierung lautet der Modellname
mj-v8.1.Wo gehört quality hin?
quality ist ein Top-level-Feld. Gültige Werte sind standard und hd.Welche Werte hat model_params.speed?
Die aktuelle Route dokumentiert
draft und fast.Kann ich quality: "hd" mit speed: "draft" kombinieren?
Nein. Laut EvoLink Docs sind
quality: "hd" und model_params.speed: "draft" gegenseitig ausgeschlossen.Unterstützt Midjourney V8.1 Bild-zu-Bild?
Ja. Setzen Sie die Bild-URL an den Anfang des Prompts und fügen Sie bei einer einzelnen Bild-URL eine Textbeschreibung hinzu.
Wie lange bleiben generierte Bildlinks gültig?
Die generierten Bildlinks sind 30 Tage gültig. Speichern Sie Ergebnisse rechtzeitig in Ihrem eigenen Storage.
Sollte ich Polling oder Callback nutzen?
Polling ist gut für Tests und interne Tools. Für Produkt-Workflows ist
callback_url robuster, sollte aber durch einen finalen Task-Statusprüfung abgesichert werden.Quellen
- EvoLink Midjourney V8.1 API Seite
- EvoLink Midjourney V8.1 Dokumentation zur Bildgenerierung
- EvoLink Midjourney V8.1 Preise
- EvoLink Modellkatalog
Midjourney V8.1 auf EvoLink starten
Testen Sie den Prompt zuerst im Midjourney V8.1 Playground, übernehmen Sie danach die gleiche Payload-Struktur in Ihr Backend.
Midjourney V8.1 auf EvoLink öffnen
