Skip to main content

​
Parameterübersicht

Zwei Einstellungen werden nicht in den Prompt geschrieben, sondern über die API gesteuert (im Prompt haben sie keine Wirkung, die Parameter werden entfernt):
  • Geschwindigkeit (draft / fast) → model_params.speed
  • Ausgabequalität (standard / hd) → Top-Level-Parameter quality
--v / --version ist auf V8.2 festgelegt und --niji wird nicht unterstützt. Siehe unten Geschwindigkeitsmodi und Ausgabequalität.

​
Grundlegende Parameter

​
Seitenverhältnis --ar

Legt das Bildseitenverhältnis fest. Es werden nur Ganzzahlverhältnisse unterstützt; Dezimalzahlen werden abgelehnt (schreiben Sie 139:100, nicht 1.39:1). Extreme Verhältnisse sind experimentell und können unvorhersehbare Ergebnisse erzeugen.
Gängige Werte: 1:1, 4:3, 3:2, 16:9, 9:16, 2:3. Die Pixelgröße finden Sie unter Ausgabequalität.

​
Chaos --chaos / --c

Steuert die Vielfalt der generierten Ergebnisse. Höhere Werte erzeugen größere Unterschiede zwischen den 4 Bildern.

​
Stilisierung --stylize / --s

Passt die Balance zwischen Realismus und künstlerischem Stil an.

​
Experimentell --exp

Ähnlich wie --stylize, aber stapelbar, erzeugt detailliertere, dynamischere und kreativere Bilder.
  • Empfohlene Werte: 5, 10, 25, 50, 100
  • Spürbare Effektänderungen von 5-50, abnehmende Wirkung von 50-100
  • Über 25-50 kann es die Wirkung von --stylize und --p überschreiben; verwenden Sie bei Kombination niedrigere Werte

​
Qualität --quality / --q

Legt die Detailstufe des Bildes fest. Bereich 1 - 4, Standard 1; 4 ist der Hochqualitätsmodus. Das Parameter wird unverändert an den Upstream durchgereicht und ändert den Preis nicht.
  • V8.2 akzeptiert 1 / 2 / 3 / 4; V8.1 akzeptiert nur 1 / 4. Werte außerhalb des Bereichs werden abgelehnt: Die Aufgabe schlägt mit einem Parameterfehler fehl, der --quality und die zulässigen Werte nennt, und reservierte Credits werden erstattet
  • Höhere Werte benötigen mehr Zeit zum Rendern
  • Nur für den Bildgenerierungs-Endpunkt; abgeleitete Aufgaben (Variation, Remix, Bearbeitung usw.) übernehmen das Quellbild

​
Raw-Modus --raw

Deaktiviert die Standard-Verschönerung für eine strengere Einhaltung der Prompt-Details. Geeignet für Fotorealismus oder präzise Kontrollszenarien.

​
Negativ-Prompt --no

Listet Elemente auf, die im Bild nicht erscheinen sollen. Mehrere Elemente werden durch Kommas getrennt. Dies entspricht einer Gewichtung dieser Elemente mit -0,5. „kein Obst” oder „ohne Obst” in der Beschreibung zu schreiben funktioniert nicht — Midjourney behandelt diese Wörter als Inhalt —, verwenden Sie daher stattdessen das Parameter.

​
Seed --seed

Fixiert den anfänglichen Zufallszustand für Vergleichstests.
  • Bereich: 0 - 4294967295
  • Der Seed fixiert nur den Ausgangszustand; er garantiert keine identische Ausgabe, und jede Änderung an Prompt, Parametern oder Modellversion verändert das Ergebnis
  • Verwenden Sie beim Testen einen festen Seed und in der Produktion einen zufälligen Seed für mehr Vielfalt

​
Bildreferenz-Parameter

​
Bildprompt

Platzieren Sie Bild-URLs am Anfang des Prompts, um den generierten Inhalt zu beeinflussen.
Gültige Kombinationsregeln:
  • Maximal 20 Bildprompts
  • Unterstützte Formate: .png, .gif, .webp, .jpg, .jpeg; höchstens 20 MB pro Datei und 16k Pixel pro Seite
  • Reine Bildprompts (ohne Text) sind inkompatibel mit --stylize und --weird
  • Funktioniert auch bei draft-Geschwindigkeit (auf dieser Plattform verifiziert); nur --tile kann nicht mit draft kombiniert werden
  • URLs müssen innerhalb weniger Sekunden öffentlich erreichbar sein, siehe Anforderungen an Eingabebilder

​
Bildgewicht --iw

Steuert den Einfluss des Bildprompts auf das Ergebnis. Bereich 0 - 3, Standard 1. Höhere Werte erzeugen Ergebnisse näher am Referenzbild.

​
Stilreferenz --sref

Gleicht den visuellen Stil (Farben, Texturen, Beleuchtung) des Referenzbilds ab, ohne den Inhalt zu kopieren. Muss mit einem Textprompt verwendet werden.
  • Mehrere unterstützt: --sref URL1 URL2; relative Gewichte können als --sref URL1::2 URL2::1 angegeben werden (vom Upstream dokumentiert, auf dieser Plattform noch nicht verifiziert)
  • Zufälliger Stil unterstützt: --sref random (gibt nach der Generierung einen Zahlencode zurück, wiederverwendbar)
  • Maximal 20 Srefs
  • Beschreiben Sie im Textprompt den Inhalt, keine Anweisungen („eine Katze”, nicht „lass das wie die Referenz aussehen”)

​
Stilgewicht --sw

Steuert den Einfluss der Stilreferenz. Bereich 0 - 1000, Standard 100.

​
Personalisierung --p

--p wird unverändert an den Upstream durchgereicht. Es akzeptiert die ID eines Moodboards, das der Upstream-Kanal unter dem Organisationskonto dieser Plattform erstellt hat; diese Plattform stellt noch keine Endpunkte zum Erstellen oder Auflisten von Moodboards bereit, und persönliche Profil-Codes von midjourney.com sind nicht anwendbar. Für einen einheitlichen Stil verwenden Sie stattdessen --sref / --sw zusammen mit --seed. --p kann nicht mit --weird kombiniert werden.

​
Geschwindigkeitsmodi

Der Geschwindigkeitsmodus wird über das API-Feld model_params.speed gesteuert (schreiben Sie nicht --draft / --fast in den Prompt). Welche Routen das Feld annehmen: Bildgenerierung akzeptiert draft / fast; Remix, Canvas-Edit, Retexture und Upload Paint nur fast; Variation und Hintergrundentfernung haben kein speed-Feld (bei Variation wird speed: fast akzeptiert und ignoriert; jeder andere Wert liefert 400).
Anders als bei V7 ist der draft-Modus von V8.2 nicht zum halben Preis – er verwendet denselben Multiplikator wie fast. Draft liefert 24 kleine Skizzen in einem Durchlauf; wählen Sie die gewünschten aus und führen Sie sie in voller Qualität erneut aus. Draft kann nicht mit hd-Qualität oder --tile kombiniert werden (--oref wird auf V8.2 grundsätzlich nicht unterstützt).Turbo ist auf V8.2 nicht verfügbar. Der Upstream-Kanal dokumentiert V8 als ohne Turbo-Unterstützung, daher wird speed: "turbo" auf jedem V8.2-Endpunkt mit 400 abgelehnt (wie bei V8.1).

​
Ausgabequalität

Die Ausgabeauflösung wird über den Top-Level-Parameter quality gesteuert, nicht über ein Prompt-Parameter. Schreiben Sie nicht --hd in den Prompt.
  • Der Qualitätsmultiplikator wird mit dem Geschwindigkeitsmultiplikator kombiniert (multipliziert)
  • hd ist inkompatibel mit draft-Geschwindigkeit
  • Auf V8.2 gibt es keinen separaten Upscale-Endpunkt; der Upstream setzt das „Hochskalieren” für V8 als neue Generierung mit hd um. Verwenden Sie daher quality: "hd", wenn Sie die 2K-Ausgabe benötigen

​
Prompt-Längenbegrenzungen

Eine zu lange Beschreibung wird abgelehnt: Die Aufgabe schlägt mit einem Parameterfehler (invalid_parameters) fehl und reservierte Credits werden erstattet.

​
Abhängigkeiten

Die folgenden Parameter erfordern andere Parameter, um wirksam zu werden:

​
Konflikte

​
Nicht unterstützte Parameter in V8.2

V8.2 entfernt nur die Parameter, die Versionssperre oder Abrechnung verfälschen würden; alle anderen Parameter werden unverändert an den Upstream durchgereicht. Unterstützt der Upstream ein Parameter nicht, schlägt die Aufgabe mit einem Parameterfehler (invalid_parameters) fehl und reservierte Credits werden erstattet — nichts wird stillschweigend verworfen.
Der Upstream-Kanal hat außerdem einen Endpunkt für anweisungsbasierte Bearbeitung für V8.1 / V8.2 geöffnet (das Midjourney Edit Model: --edit mit bis zu 4 Referenzbildern, optionales Neuzeichnen per transparenter Maske). Er ist auf dieser Plattform noch nicht verfügbar und wird derzeit eingeplant. mj-v8.2-edit und mj-v8.2-upload-paint sind Canvas-Bearbeitungen (canvas + img_pos + optionale mask), und mj-v8.2-retexture ist das Retexture-Werkzeug. Wird --edit auf einem der aktuellen Endpunkte in den Prompt geschrieben, lehnt der Upstream die Anfrage ab.

​
Anforderungen an Eingabebilder

Diese Regeln gelten für Bildprompts, --sref-URLs und das Feld image_urls von Retexture / Upload-Paint / Remove-BG.
  • Nur öffentliche HTTP(S)-URLs. Base64 und Data-URLs werden für Eingabebilder nicht akzeptiert. Die URL selbst darf höchstens 1024 Zeichen lang sein.
  • Der Upstream lädt das Bild beim Erstellen der Aufgabe synchron herunter und bricht nach etwa 10 Sekunden ab (auf dieser Plattform gemessen). Kann die Datei nicht rechtzeitig heruntergeladen werden, schlägt die Anfrage mit 400 fehl und es wird keine Aufgabe erstellt. Bildhoster außerhalb Festlandchinas (imgur, ibb, raw.githubusercontent, pinimg, picsum und ähnliche) scheitern in der Praxis fast immer. Hosten Sie Bilder auf einem schnellen CDN oder laden Sie sie zuerst mit der Datei-Upload-API hoch und verwenden Sie die zurückgegebene URL.
  • Unterstützte Formate: .png, .gif, .webp, .jpg, .jpeg (mj-v8.2-remove-bg akzeptiert nur .png, .jpg, .jpeg). Höchstens 20 MB pro Datei und 16k Pixel pro Seite; sehr große Dateien können das Zeitbudget für den Download selbst von einem erreichbaren Host aus überschreiten.
  • mj-v8.2-remove-bg akzeptiert nicht die signierten Ergebnislinks, die Midjourney-Aufgaben auf dieser Plattform zurückgeben (URLs mit Expires / Signature). Hosten Sie das Bild neu oder verwenden Sie eine unsignierte URL. Retexture und Upload-Paint akzeptieren diese Links.
  • Bildprompts und --sref-URLs werden auch bei draft-Geschwindigkeit akzeptiert (auf dieser Plattform verifiziert); nur --tile wird zusammen mit draft abgelehnt.

​
Prompt-Format-Richtlinien

​
Grundstruktur

​
Schreibregeln

  • Parameter stehen am Ende des Textprompts
  • Ein Leerzeichen ist vor -- erforderlich
  • Keine Satzzeichen in Parametern verwenden
  • Nach Parametern darf kein Text folgen
  • Um Wörter im Bild darzustellen, setzen Sie sie in doppelte Anführungszeichen: a neon sign that says "OPEN" --ar 3:2

​
Beispiele

​
Aufgaben-Workflow

Alle sieben V8.2-Modelle sind asynchron und werden pro Aufruf abgerechnet.
  1. Absenden — POST /v1/images/generations antwortet sofort mit einer Aufgaben-id, status: processing und usage.credits_reserved. Der Upstream-Job wird im Hintergrund erstellt.
  2. Abfragen — GET /v1/tasks/{task_id} (Aufgabenstatus abfragen). Der Upstream gibt für Generierung und Bearbeitungen eine durchschnittliche Dauer von etwa 40 Sekunden an; fragen Sie alle 3–5 Sekunden ab, mit einer clientseitigen Obergrenze von etwa 20 Minuten, und senden Sie denselben Prompt nicht erneut, solange eine Aufgabe noch processing ist. Der Upstream begrenzt die Parallelität pro Organisationskonto; wird die Grenze überschritten, wartet diese Plattform automatisch und reicht die Aufgabe erneut ein – für Sie dauert die Aufgabe dann nur länger, sie schlägt nicht fehl.
  3. Ergebnis lesen — wenn status gleich completed ist, enthält results die Bild-URLs: 4 bei fast, 24 bei draft. usage.cost zeigt die endgültige Belastung.
  4. Bilder speichern — Ergebnislinks sind signierte OSS-URLs, die 30 Tage gültig sind; die Signatur gilt nur für GET, eine HEAD-Anfrage liefert daher 403. Laden Sie alles herunter oder hosten Sie es neu, was Sie behalten möchten.
  5. Optionaler Callback — übergeben Sie callback_url (HTTPS, öffentlicher Host), um bei completed / failed benachrichtigt zu werden. Callbacks werden 3-mal mit Backoff wiederholt; betrachten Sie sie als Hinweis und bestätigen Sie den Status über die Aufgabenabfrage.
Fehlgeschlagene Aufgaben werden vollständig erstattet, einschließlich bei der Erstellung abgelehnter Anfragen, Parameterablehnungen durch den Upstream (--oref, --q außerhalb des Bereichs, zu lange Beschreibung), fehlgeschlagener Bild-Downloads sowie Aufgaben, bei denen die Inhaltsmoderation des Upstreams alle Bilder blockiert. Solange mindestens ein Bild die Moderation passiert, ist die Aufgabe completed und wird normal abgerechnet. Fehlercodes und Hinweise zu Wiederholungsversuchen finden Sie auf der Seite Fehlercodes.

​
Abgeleitete Aufgaben

Variation, Remix und Canvas-Bearbeitung verwenden als Quelle eine abgeschlossene Aufgabe der mj-v8.2-Serie desselben Kontos (task_id + image_number). Vom Upstream-Kanal dokumentierte und auf dieser Plattform verifizierte Regeln:
  • Quellaufgaben werden für diese abgeleiteten Operationen upstream von Midjourneys V7-Engine gerendert, das Ergebnis kann sich daher stilistisch geringfügig vom Quellbild unterscheiden. Die Preise bleiben unverändert. V8.1-Quellen werden nicht akzeptiert.
  • image_number wählt das Quellbild aus: 0–3 bei einer fast-Quellaufgabe, 0–23 bei einer draft-Quellaufgabe (alle 24 Skizzen können als Quelle für Variation, Remix und Edit verwendet werden).
  • Ergebnisse von mj-v8.2-upload-paint, mj-v8.2-retexture und mj-v8.2-remove-bg können nicht als Quelle für Variation, Remix oder Edit verwendet werden; der Upstream erlaubt für sie nur das Hochskalieren, das diese Route nicht bereitstellt. Verwenden Sie stattdessen eine Bildgenerierungs-, Variations-, Remix- oder Edit-Aufgabe als Quelle.

​
FAQ

Muss ich meine Prompts beim Wechsel von V8.1 ändern? Nein. Ändern Sie den Wert von model; Prompts, model_params und Preise bleiben unverändert. Nur --oref / --ow funktionieren nicht mehr, und --q akzeptiert zusätzlich zu 1 und 4 auch 2 und 3. Warum schlägt mein Bildprompt mit einem 400 fehl, bevor überhaupt eine Aufgabe erstellt wird? Der Upstream konnte das Bild nicht innerhalb seines Zeitbudgets herunterladen. Verschieben Sie die Datei auf einen schnellen, öffentlich erreichbaren Host oder verwenden Sie die Datei-Upload-API, und versuchen Sie es dann erneut. Gibt es eine Turbo-Geschwindigkeit? Nein. Der Upstream dokumentiert V8 als ohne Turbo-Unterstützung, daher bietet V8.2 wie V8.1 nur draft und fast. Ist --q 4 langsamer oder teurer? Es wird nicht anders abgerechnet. Der Upstream beschreibt 4 als Hochqualitätsmodus, der mehr Zeit zum Rendern benötigt. Kann ich ein V8.2-Bild hochskalieren? Auf V8.2 gibt es keinen Upscale-Endpunkt. Generieren Sie stattdessen mit quality: "hd" für eine native 2K-Ausgabe.

​
Hinweis zur Inhaltsmoderation

Midjourney verfügt über ein integriertes Moderationssystem. Jedes Bild wird einzeln moderiert: Werden einige der generierten Bilder gefiltert, bleibt die Aufgabe completed, die übrigen Bilder werden geliefert und die Aufgabe 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 den Inhaltsrichtlinien entsprechen.