Einführung
Qwen Image 3.0 Pro Bildbearbeitung bearbeitet ein bis drei Referenzbilder nach einer Anweisung. Mit einer Referenz ist es ein präziser Eingriff – eine Coverzeile, ein Kleidungsstück, ein Licht. Mit zwei oder drei führt es zusammen, sofern der Prompt sagt, welche Vorlage was beisteuert.
Qwen Image 3.0 Pro ist die detailreiche Stufe der Qwen-Bildreihe von Alibaba: Prompts bis 5.000 Zeichen, acht Seitenverhältnisse, eine 1K- oder 2K-Stufe und Bearbeitung mit ein bis drei Referenzen. Gebaut für Bilder, die ausgeliefert werden, unzensiert.
Den Qwen-Image-3.0-Pro-Modus nach Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Eine schriftliche Art Direction oder ein Design-Brief | Qwen Image 3.0 Pro Text-zu-Bild |
| Ein freigegebenes Ausgangsbild, das überarbeitet werden soll | Qwen Image 3.0 Pro Bildbearbeitung |
Wichtige Funktionen und Highlights
Bildkomposition mit Blick auf Text
Qwen Image 3.0 Pro 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. Benennen Sie die Änderung und benennen Sie, 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 – eine Referenz mit anderer Form kommt umgeformt zurück. Setzen Sie es bewusst, wenn der ursprüngliche Ausschnitt überleben muss. |
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. |
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. Hier am nützlichsten gegen Artefakte, zu denen eine Bearbeitung einlädt: Stoffnähte, Reste alter Beschriftung, doppelter Schmuck. höchstens 2000 Zeichen |
seed | Nein | Festsetzen, um zwei Formulierungen einer Anweisung gegen denselben Zug zu vergleichen; weglassen, wenn Sie echte Vielfalt wollen. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.04 / Bild |
| $0.075 / Bild |
Anwendungsfälle
Ein geliefertes Motiv verfeinern
Nutzen Sie diesen Modus, wenn ein bis drei freigegebene Bilder ins Ergebnis übergehen sollen. Führen Sie sie in image_urls in der Reihenfolge auf, in der Ihr Prompt sie nennt, und geben Sie jedem eine Rolle – das Gesicht aus dem ersten, das Kleidungsstück aus dem zweiten –, denn Rollen werden nie abgeleitet.
Magazincover und unzensierte Editorials
Behalten Sie ein freigegebenes Cover und ändern Sie pro Durchgang ein Element: eine Coverzeile, ein Kleidungsstück oder das Licht. Wer im selben Aufruf neu stylt und neu beschriftet, riskiert driftende Gesichter; teilen Sie das in zwei Anfragen auf.
Plakat- und Außenwerbungsentwürfe
Nehmen Sie ein freigegebenes Plakatmotiv und tauschen Sie für die nächste Auflage die Datumszeile oder den Rechtshinweis aus. Zitieren Sie alte und neue Zeichenfolge, lassen Sie aspect_ratio bei der Form des Bildes und beschreiben Sie alles andere als unverändert.
Verpackungs- und Etikettenentwürfe
Schicken Sie ein Produkt-Rendering und etikettieren Sie es neu: Zitieren Sie Markenname und kurzen Claim, sagen Sie, auf welcher Fläche sie sitzen, und setzen Sie negative_prompt gegen Schriftreste des alten Etiketts ein.
Prompt-Leitfaden und Praxistipps
Das Cover-Format wählen und bei 2k bleiben
Wählen Sie 3:4 oder 2:3 für Cover und Plakate; das Bild wird für diese Form komponiert, nicht in sie hineingeschnitten. Lassen Sie die Auflösung für alles mit Schrift auf 2k – der Vorteil dieser Stufe verschwindet bei 1k.
Jede Zeichenfolge zitieren und sagen, wo sie steht
Zitieren Sie bei einer Textänderung die alte und die neue Zeichenfolge, nennen Sie die Position und sagen Sie dann, welche Elemente unberührt bleiben müssen, etwa der Titel. Alles, was die Anweisung nicht erwähnt, kann neu gezeichnet werden.
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 portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.
Eine Textänderung mit einer Referenz: beide Zeichenfolgen zitiert, der Titel ausdrücklich geschützt. Liefern Sie Ihr eigenes Cover – der Wert von image_urls ist ein Platzhalter, kein gehostetes Beispiel.
Das Ergebnis prüfen, bevor Sie iterieren
Das Zusammenführen gelingt, wenn der Prompt jeder Referenz eine Rolle zuweist; mit drei Vorlagen und ohne benannte Rollen entsteht eine Mischung, die niemand bestellt hat. Eine Neubeschriftung an Ort und Stelle braucht alte und neue Zeichenfolge in Anführungszeichen. Gesichter driften, wenn Sie im selben Aufruf neu stylen und neu beschriften; teilen Sie das in zwei Durchgänge auf.
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-pro/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.
