Skip to main content
POST
Midjourney verfügt über ein integriertes Moderationssystem. Wenn einige generierte Bilder durch die Moderation gefiltert werden, können die für diese Anfrage verbrauchten Credits nicht erstattet werden. Bitte achten Sie darauf, dass Ihre Prompts 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 hinzufuegen:

Body

application/json
model
enum<string>
Standard:mj-v7-variation
erforderlich

Modellname

Verfügbare Optionen:
mj-v7-variation
model_params
object
erforderlich

Modellparameter

prompt
string | null

Optionaler Prompt; falls angegeben, dient als Remix-Prompt zur Inhaltsaenderung

prompt ist optional. Fehlende, leere oder nur aus Leerzeichen bzw. kontrollierten Geschwindigkeits-/Versionsparametern bestehende Prompts verwenden immer Fast zum Fast-Preis, auch bei speed=turbo. Mit nicht leerem Prompt verwenden fehlende Geschwindigkeit oder fast den Fast-Modus; turbo kostet das Doppelte. Playground bietet nur Fast. Die Quellaufgabe muss abgeschlossen sein und dem aktuellen Benutzer gehören; ohne Prompt werden Bilderzeugung und unterstützte Variation-, Pan- und Outpaint-Ergebnisse akzeptiert.

Beispiel:

"Zu Sonnenuntergangsszene wechseln"

callback_url
string<uri>

HTTPS-Callback-URL fuer Aufgabenabschluss

Callback-Zeitpunkt:

  • Ausgeloest bei Abschluss, Fehler oder Abbruch der Aufgabe
  • Nach Abrechnungsbestaetigung gesendet

Sicherheitsbeschraenkungen:

  • Nur HTTPS-Protokoll
  • Callbacks an private IPs verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
  • URL-Laenge max 2048 Zeichen

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Bis zu 3 Wiederholungen (nach 1s/2s/4s)
  • Antwortformat entspricht der Aufgabenabfrage
  • 2xx-Statuscode = erfolgreich; andere loesen Wiederholungen aus
Beispiel:

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

Antwort

Aufgabe erfolgreich erstellt

created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757165031

id
string

Aufgaben-ID

Beispiel:

"task-unified-1757165031-mjv7"

model
string

Tatsaechlich verwendeter Modellname

Beispiel:

"mj-v7-variation"

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

type
enum<string>

Aufgabenausgabetyp

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"image"

usage
object

Nutzungs- und Abrechnungsinformationen

effective_speed
enum<string>

prompt ist optional. Fehlende, leere oder nur aus Leerzeichen bzw. kontrollierten Geschwindigkeits-/Versionsparametern bestehende Prompts verwenden immer Fast zum Fast-Preis, auch bei speed=turbo. Mit nicht leerem Prompt verwenden fehlende Geschwindigkeit oder fast den Fast-Modus; turbo kostet das Doppelte. Playground bietet nur Fast. Die Quellaufgabe muss abgeschlossen sein und dem aktuellen Benutzer gehören; ohne Prompt werden Bilderzeugung und unterstützte Variation-, Pan- und Outpaint-Ergebnisse akzeptiert.

Verfügbare Optionen:
fast,
turbo