Einführung
Qwen Image 2 Bildbearbeitung nimmt genau ein Referenzbild und eine Anweisung entgegen und liefert ein bearbeitetes Ergebnis: neu beleuchtet, neu gestylt, neu eingekleidet oder mit ergänztem Schriftzug – so, wie der Prompt es beschreibt.
Qwen Image 2 ist das Allzweck-Bildmodell von Alibaba: Prompts bis 800 Zeichen, auf Chinesisch oder Englisch direkt gelesen, fünf Seitenverhältnisse für Text-zu-Bild und ein Bearbeitungs-Endpunkt, der genau eine Referenz im gewählten Format überarbeitet. Pro Anfrage kommt ein Bild zurück; ein optionaler Seed hält eine Ziehung stabil, während Sie vergleichen.
Den Qwen-Image-2-Modus nach Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Eine schriftliche Art Direction oder ein Design-Brief | Qwen Image 2 Text-zu-Bild |
| Ein freigegebenes Ausgangsbild, das überarbeitet werden soll | Qwen Image 2 Bildbearbeitung |
Wichtige Funktionen und Highlights
Zweisprachig prompten
Qwen Image 2 liest chinesische und englische Prompts direkt. Ein Team kann also in der Sprache arbeiten, in der der Brief am klarsten ist, statt ihn für die Übergabe neu zu schreiben.
Eine schriftliche Änderung an einem gelieferten Bild
Der Bearbeitungsmodus beginnt mit einem gelieferten Bild und einer schriftlichen Anweisung. Wählen Sie diesen Einstieg, wenn Identität oder Komposition bereits stehen und es um eine gezielte Änderung geht, nicht um ein neues Konzept.
Zwei klar getrennte Einstiege
Text-zu-Bild baut eine neue Szene aus einer Art Direction auf, die Bildbearbeitung überarbeitet ein vorhandenes Motiv. Wer zuerst das Ausgangsmaterial festlegt, bewertet einen Bearbeitungs-Brief nicht versehentlich wie eine Neugenerierung.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 800 Zeichen, die das Ergebnis beschreiben, nicht die Quelle. Sagen Sie, was identisch bleiben muss und was sich ändert; alles Ungesagte kann abdriften. mindestens 1 Zeichen · höchstens 800 Zeichen |
image_urls | Ja | Genau eine öffentlich abrufbare jpeg-, png- oder webp-URL zu einem Bild, an dem Sie die Rechte halten. Ein zweites Bild wird abgelehnt, bevor die Anfrage die Plattform verlässt. mindestens 1 Einträge · höchstens 1 Einträge |
aspect_ratio | Nein | Standardmäßig 1:1, alternativ 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 und 21:9. |
seed | Nein | Weglassen für einen neuen Zug bei jedem Aufruf; setzen, um zwei Formulierungen derselben Bearbeitung bei identischem Zug zu vergleichen. |
Preis
$0.035 / Bild
Anwendungsfälle
Ein geliefertes Motiv verfeinern
Nutzen Sie diesen Modus, wenn ein vorhandenes Foto Motiv, Komposition oder Stil festlegen soll. Senden Sie es als einzigen Eintrag in image_urls, sagen Sie, was sich ändert und was identisch bleiben muss, und vergleichen Sie das Ergebnis in der späteren Einsatzgröße mit der Vorlage.
Ein Produkt in neuer Szene
Senden Sie das Produktfoto und beschreiben Sie die Umgebung, in der es stehen soll, einschließlich des Lichts, das es aufnehmen soll. Ein Aufruf, ein Bild. Muss die Umgebung aus einem zweiten Foto stammen, nehmen Sie ein Bearbeitungsmodell, das mehrere Referenzen annimmt.
Zweisprachige Kampagnenproduktion
Passen Sie ein freigegebenes Key Visual für einen anderen Markt an, indem Sie einen Schriftzug auf einer freien Fläche anfordern – im Prompt genau so geschrieben, wie er erscheinen soll, auf Chinesisch oder Englisch. Bleiben Sie bei einer kurzen Zeichenfolge: Schilder und längere Texte sind Sache der Qwen-Image-3.0-Reihe.
Figuren und Kostüme
Behalten Sie die Person aus einem Foto und beschreiben Sie das neue Kleidungsstück in Worten, samt Stoff und Glanz. Setzen Sie aspect_ratio auf das Format des Fotos – Standard ist 1:1 –, damit das Ergebnis nicht ungefragt zum Quadrat wird.
Prompt-Leitfaden und Praxistipps
Erst das Format, dann der Text
Die Ausgabeform kommt aus aspect_ratio, nicht aus der Vorlage. Standard ist 1:1, verfügbar sind acht Seitenverhältnisse, darunter 3:2, 2:3 und 21:9. Stellen Sie das passende Format ein, bevor Sie die Anweisung schreiben.
800 Zeichen für eine vollständige Szene
Beschreiben Sie das Ergebnis, nicht die Vorlage. Nennen Sie zuerst, was identisch bleiben muss, dann, was sich ändert, und nutzen Sie den Rest für das neue Set und das Licht – alles, was unerwähnt bleibt, kann abdriften.
Das mitgelieferte Beispiel anpassen
Beginnen Sie mit dem veröffentlichten Beispiel und ersetzen Sie die kreative Richtung, behalten Sie aber den Eingabevertrag dieses Modus bei.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Eine Neuinszenierung mit einer Referenz: Die Frau und der Morgenmantel bleiben, die Neonbar wird in Worten beschrieben, und die Lichtanpassung ist ausdrücklich genannt. Das Bild muss von Ihnen kommen – die URL hier ist ein Platzhalter, kein gehostetes Beispiel.
Das Ergebnis prüfen, bevor Sie iterieren
Einen Stärkeregler gibt es hier nicht, und angenommen wird genau eine Referenz – eine zweite wird abgelehnt, bevor die Anfrage die Plattform verlässt. aspect_ratio ist standardmäßig 1:1 und folgt nicht der Vorlage; ein Hochformatfoto kommt also quadratisch zurück, wenn Sie das Format nicht setzen. Wie viel von der Vorlage erhalten bleibt, entscheidet die Genauigkeit Ihrer Anweisung. Fixieren Sie seed, wenn Sie zwei Formulierungen derselben Bearbeitung auf identischer Ziehung vergleichen wollen.
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-2/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.


















