Einführung
Qwen Image 3.0 Bildbearbeitung nimmt ein bis drei Referenzbilder und eine Anweisung entgegen und liefert ein bearbeitetes Ergebnis. Mit einer Referenz ist es eine gezielte Änderung; mit zwei oder drei führt es zusammen – ein Gesicht aus dem einen, ein Kleidungsstück oder einen Hintergrund aus dem anderen –, sofern der Prompt sagt, welches Bild was liefert.
Qwen Image 3.0 ist das Bildmodell von Alibaba mit Schwerpunkt auf Schriftdarstellung: Prompts bis 5.000 Zeichen, acht Seitenverhältnisse, eine 1K- oder 2K-Stufe und ein Bearbeitungs-Endpunkt, der ein bis drei Referenzen liest. Unzensiert, ohne ein Flag zu setzen.
Den Qwen-Image-3.0-Modus nach Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Eine schriftliche Art Direction oder ein Design-Brief | Qwen Image 3.0 Text-zu-Bild |
| Ein freigegebenes Ausgangsbild, das überarbeitet werden soll | Qwen Image 3.0 Bildbearbeitung |
Wichtige Funktionen und Highlights
Bildkomposition mit Blick auf Text
Qwen Image 3.0 eignet sich für visuelle Konzepte, bei denen vorgegebener Wortlaut, Komposition und Bildbehandlung zusammen betrachtet werden müssen. Behandeln Sie erzeugte Schrift als Designentwurf und lesen Sie sie vor der Veröffentlichung Korrektur.
Neue Komposition und Überarbeitung einer Vorlage sind getrennte Aufgaben
Nutzen Sie Text-zu-Bild, um ein Motiv aus einem schriftlichen Brief aufzubauen. Nutzen Sie die Bildbearbeitung, wenn ein vorhandenes Bild die Identität, den Aufbau oder das Material liefert, das bei einer klar umrissenen Änderung erhalten bleiben muss.
Erst die Hierarchie prüfen, dann die Dekoration
Legen Sie bei Postern, Verpackungen und Kampagnenkonzepten zuerst die Hierarchie der Botschaften und den Blickpunkt fest. Ein ansprechendes Ergebnis verfehlt die Aufgabe trotzdem, wenn der freigegebene Text oder die Produktfakten nicht korrekt dargestellt sind.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Sagen Sie, was sich ändert und was identisch bleiben muss; alles Unerwähnte kann neu gezeichnet werden. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_urls | Ja | Ein bis drei öffentlich abrufbare URLs für Bilder, an denen Sie die Rechte halten. mindestens 1 Einträge · höchstens 3 Einträge |
aspect_ratio | Nein | Gilt für das Ergebnis, nicht für die Quellen. |
resolution | Nein | 1k oder 2k, Vorgabe 2k. Das ist die Stufenwahl, die den Preis ändert; jedes Referenzbild in |
num_outputs | Nein | Fest auf 1: ein bearbeitetes Bild pro Anfrage. Ob eine Anweisung mehrdeutig war oder nur der Zug unglücklich, zeigen zwei oder drei parallele Anfragen ohne Seed. |
enable_prompt_expansion | Nein | In dieser Familie standardmäßig an. Sie füllt dünne Briefings auf und schreibt ausführliche um – ausschalten, sobald Ihr Prompt eine präzise Shot-Beschreibung ist. Standardwert: |
negative_prompt | Nein | Bis zu 2.000 Zeichen Ausschlüsse. höchstens 2000 Zeichen |
seed | Nein | Beim Ausprobieren weglassen. Fixieren Sie ihn, um zwei Formulierungen derselben Anweisung gegen denselben Zug zu vergleichen. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.03 / Bild |
| $0.03 / Bild |
Anwendungsfälle
Ein geliefertes Motiv verfeinern
Nutzen Sie diesen Modus, wenn ein bis drei vorhandene Bilder Motiv, Aufbau oder Material festlegen sollen. Führen Sie sie in image_urls in der Reihenfolge auf, in der Ihr Prompt sie nennt – erstes, zweites, drittes –, und sagen Sie, was jedes liefert.
Figurensets und Modeserien
Behalten Sie die Figur aus einem freigegebenen Bild und ändern Sie pro Anfrage ein Detail: Garderobe, Licht oder Pose. Fixieren Sie seed, wenn Sie zwei Formulierungen derselben Änderung vergleichen, damit nicht die Ziehung den Unterschied macht.
Lokalisierte Textvarianten
Schicken Sie das freigegebene Bild an den Bearbeitungs-Endpunkt und ändern Sie nur die Worte auf dem Schild. Pose, Garderobe, Licht und Farblook werden als unverändert beschrieben, sodass sich die Variante im Text unterscheidet, nicht im ganzen Bild.
Szenenbilder für Hotellerie und Ausstattung
Schicken Sie ein freigegebenes Zimmer- oder Barbild und ergänzen oder ersetzen Sie die Beschilderung: einen Türanhänger, eine Menütafel, eine Neonzeile. Zitieren Sie den neuen Wortlaut, und wenn schon ein Schild existiert, zitieren Sie auch die alte Zeichenfolge.
Prompt-Leitfaden und Praxistipps
Zuerst Format und Stufe wählen
aspect_ratio gilt für das Ergebnis, nicht für die Vorlagen: Eine Referenz in anderer Form kommt umgeformt zurück; passen Sie das Format also bewusst an, wenn der ursprüngliche Bildausschnitt erhalten bleiben soll. Lassen Sie die Auflösung für alles mit Schrift auf 2k; jedes Referenzbild erhöht außerdem den Preis.
Die Szene beschreiben und den Wortlaut wörtlich zitieren
Sagen Sie zuerst, was identisch bleiben muss, und dann, was sich ändert; alles, was unerwähnt bleibt, kann neu gezeichnet werden. Zitieren Sie bei Textänderungen den alten und den neuen Wortlaut. negative_prompt nimmt bis zu 2.000 Zeichen auf und hilft gegen Schriftreste und doppelten Schmuck.
Das mitgelieferte Beispiel anpassen
Beginnen Sie mit dem veröffentlichten Beispiel mit aspect_ratio: 3:4 und resolution: 2k. Ersetzen Sie Motiv und kreative Richtung, behalten Sie aber den Eingabevertrag dieses Modus bei.
Keep the bathroom, the mirror, the steam, the woman's reflection, the basin, the lighting and the whole composition exactly as they are. On the blank fogged area of the mirror to the left of her reflection, add two lines of writing drawn in bold red lipstick, thick glossy strokes with clear dark glass showing through where the fog is wiped away, slightly dripping at the ends: the first line reads 'WAIT UP' and the second line below reads 'FOR ME'. The lettering is large, hand-drawn, neatly spelled and clearly legible, and catches the warm bathroom light. Change nothing else.
Schrift auf einer Fläche, die weder glatt noch sauber ist: beschlagenes Glas, auf dem jeder Strich das Kondenswasser wegwischen und dunkles Glas freilegen muss, mit einem kleinen Tropfen an den Enden. Die Anweisung begrenzt die Änderung auf die freie Fläche links vom Spiegelbild und verlangt, dass alles andere bleibt. Liefern Sie Ihr eigenes Ausgangsbild – die URL ist ein Platzhalter.
Das Ergebnis prüfen, bevor Sie iterieren
Der Prompt muss sagen, welche Referenz was liefert; bei zwei oder drei Vorlagen leitet das Modell die Rollen nicht selbst ab. Text an Ort und Stelle zu ändern funktioniert, wenn Sie alten und neuen Wortlaut ausschreiben. Bei starken Änderungen driftet die Identität; ändern Sie also eine Sache pro Durchgang, statt im selben Aufruf neu zu stylen und neu zu beschriften.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
