Referenzbilder verwenden

Wofür Referenzen gedacht sind

Referenzbilder helfen dem Modell, Figur oder Objekt visuell zu verstehen. Sie sind weder automatisch zeitlich geordnete Keyframes noch separate Animationsebenen oder eine Garantie, jedes Detail exakt zusammenzuführen. Verwende einen stimmigen Bildsatz desselben Motivs und beschreibe die gewünschte Bewegung.

Wähle im Studio den Referenzbildmodus. Füge das erste Bild hinzu, wähle ein kompatibles Modell und belege die angebotenen zusätzlichen Referenzplätze. Nutze hochwertige, konsistente statt unzusammenhängender Bilder.

Das Bildlimit schließt das erste Bild ein

max_reference_images ist die Gesamtzahl, nicht die Zahl zusätzlicher Plätze. Liefert die Modellabfrage beispielsweise 3, füllen das erste Bild und zwei weitere Referenzen dieses Limit. Das ist ein Beispiel, keine allgemeine Produktgrenze.

Die Oberfläche leitet verfügbare Plätze vom Modell ab. Prüfe beim Modellwechsel aktive Referenzen; gehe nicht davon aus, dass alle bisherigen Bilder weiterverwendet werden. Ist reference_image_duration_seconds vorhanden, ist die Referenzdauer bei diesem Modell fest. Andere Modelle können andere Optionen bieten.

Nimm nicht an, dass Referenzen nur bei einem bestimmten Anbieter oder immer für acht Sekunden verfügbar sind. Siehe Modelle und Prompts.

Den Bildsatz konsistent halten

Halte Proportionen, Kostüm und Hintergrundbehandlung einheitlich. Widersprüchliche Perspektiven oder Kleidung können die gewünschte Bewegung beeinträchtigen. Beginne mit dem kleinsten hilfreichen Satz, prüfe das Ergebnis und stelle bei Bedarf bewusst eine neue Anfrage.

Für eine explizite Endpose ist der Start-/Endbildmodus geeignet. In öffentlichen Anfragen lassen sich Referenzen nicht mit last_frame kombinieren. Die Eingabe-Leinwand wird im Referenzmodus nicht unterstützt.

Bei Alpha Key muss jede beteiligte Referenz einschließlich des ersten Bilds echtes Alpha enthalten. Ein normales JPEG wird nicht transparent, nur weil ein anderes Bild Transparenz hat.

Zuordnung für API und MCP

input.first_frame ist die erste Referenz. input.reference_images enthält die zusätzlichen Bilder; wiederhole darin nicht das erste Bild. Lade jedes lokale Bild über den dokumentierten Ablauf hoch und verwende seine abgeschlossene file_id. Öffentliche Bildeingaben bieten keine internen Studio-Rollen- oder Beschriftungsfelder.

Wähle ein aktuelles Modell mit supports_reference_images und passendem modes-Eintrag. Beachte Gesamtbildlimit, Dauer, Auflösung und modusspezifische Seitenverhältnisse. Die generierten Schemas nennen Feldgrenzen; die aktuelle Modellabfrage kann strengere Grenzen liefern.

Kalkuliere den vollständigen Bildsatz und alle Einstellungen. Fügst du nach der Freigabe Referenzen hinzu oder entfernst welche, kalkuliere erneut und bestätige die Änderung. Der MCP-Workflow erläutert lokale Byteübertragung und sichere Generierung.