Einführung
Qwen Image Edit Spicy bearbeitet ein einzelnes Ausgangsbild nach einer einzigen Anweisung in einfachem Englisch. Es gibt keine Maske, keine Bereichsauswahl und keinen Regler für die Abweichung – der Satz ist die gesamte Steuerung, und geschützt ist nur, was Sie benennen.
Die Anfrage besteht aus image_url, prompt und einem optionalen seed; ein Seed von 0 fordert eine zufällige Ziehung an. Pro Anfrage kommt ein Bild zurück.
Wichtige Funktionen und Highlights
Keine Maske, keine Stärke, kein Inpainting-Ablauf
Die meisten Editoren lassen Sie erst eine Region und ein Maß der Abweichung wählen, bevor sich etwas ändert. Dieser nimmt einen Satz. Nennen Sie, was sich ändert und was bleiben muss, und schicken Sie ihn ab. Dass es keinen Stärkeregler gibt, ist Absicht: Bewahrung wird in Worten ausgedrückt, und genau so lässt sich eine Bearbeitung später auch nachvollziehen.
Gewagte Kleiderwechsel, ungefiltert
Ein Kleiderwechsel, den gefilterte Editoren ablehnen, ist hier eine ganz normale Anweisung und kein Sonderfall. Es gibt kein Reife-Flag und keinen anderen Endpunkt, auf den die Anfrage umgeleitet wird. Ihre Formulierungen in der Anweisung werden so weitergegeben, wie sie geschrieben sind.
Ein Schild neu beschriften, ohne den Raum neu zu zeichnen
Weil das Modell die Typografie der Qwen-Image-Reihe erbt, kann es Text ändern, der bereits im Bild steht – einen Türanhänger, eine Menütafel, ein Flaschenetikett. Zitieren Sie die vorhandene Zeichenfolge und die gewünschte und halten Sie fest, dass Pose, Bildausschnitt und Farblook unverändert bleiben.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Ein öffentlicher, direkt herunterladbarer Link auf ein Bild, an dem Sie die Rechte halten. mindestens 1 Zeichen |
prompt | Ja | Eine Anweisung, die beide Hälften der Bearbeitung trägt. mindestens 1 Zeichen |
seed | Nein | Denselben seed mit demselben Bild und derselben Anweisung senden, damit der Zug zwischen zwei Bearbeitungen gleich bleibt und nur die geänderte Stelle abweicht; ein Vergleichswe… |
Preis
$0.038 / Bild
Anwendungsfälle
Ein geliefertes Motiv verfeinern
Nutzen Sie diesen Endpunkt, wenn ein vorhandenes Foto das Foto bleiben und sich nur eine Sache ändern soll. Senden Sie es als image_url, benennen Sie die Änderung und die Elemente, die bleiben müssen – Pose, Bildausschnitt, Licht, Farblook – und vergleichen Sie das Ergebnis mit der Vorlage.
Anweisungen, die andere Editoren ablehnen
Kühne Garderoben-Anweisungen, die gefilterte Bearbeitungs-APIs zurückweisen, laufen hier als gewöhnliche Bearbeitungen. An der Anfrage ändert sich nichts: dieselben Feldnamen, derselbe Task-Lebenszyklus, dieselbe asynchrone Abfrage des Ergebnisses.
Garderobenwechsel an einem freigegebenen Bild
Sie haben bereits ein Porträt, dessen Pose und Licht funktionieren. Tauschen Sie das Outfit gegen Abendmode oder einen gewagteren Look, ohne die Szene neu zu generieren, sodass Gesicht, Raum und Farbgebung die Änderung überstehen und das Set stimmig bleibt.
Textvarianten für ein bereits bezahltes Foto
Ändern Sie nur die Worte auf einem Schild, einem Anhänger oder einem Etikett und behalten Sie das Foto identisch. Günstiger und weit konsistenter, als die ganze Szene für jede Sprache oder jede Kampagnenzeile neu zu erzeugen.
Prompt-Leitfaden und Praxistipps
Das Ausgangsbild abrufbar hosten
image_url muss ein öffentlicher, direkt herunterladbarer Link sein – keine Viewer-Seite und keine signierte URL, die abläuft, bevor die Task läuft. Die Vorlage bestimmt Komposition und Qualitätsobergrenze des ganzen Durchgangs.
Eine Anweisung schreiben, die beide Seiten der Bearbeitung nennt
Sagen Sie in je einem Satz, was sich ändert und was identisch bleiben muss. Die Bearbeitung für diesen Endpunkt entstand aus: „Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.“
Das mitgelieferte Beispiel anpassen
Beginnen Sie mit dem veröffentlichten Beispiel, image_url ist dabei eine öffentlich erreichbare URL. Ersetzen Sie Motiv und kreative Richtung, behalten Sie aber den Eingabevertrag dieses Modus bei.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
Die exakte Anweisung hinter der Bearbeitung, die für diesen Endpunkt gezeigt wird: eine Kleidungsänderung plus eine Textänderung am Türanhänger, wobei Pose, Bildausschnitt, Licht und Gradierung ausdrücklich als unverändert benannt sind. Liefern Sie Ihr eigenes Ausgangsbild – die image_url hier ist ein Platzhalter, kein gehostetes Beispiel.
Das Ergebnis prüfen, bevor Sie iterieren
Der verlässliche Weg ist eine Änderung pro Aufruf, bei der die zu erhaltenden Elemente ausdrücklich genannt werden – Pose, Bildausschnitt, Licht, Farblook. Verlangen Sie Garderobenwechsel und Textänderung in derselben Anweisung, driftet meist eines von beiden. Die Identität hält bei einer einzelnen gezielten Bearbeitung gut und lässt über lange Ketten nach; bearbeiten Sie also erneut vom Original aus, nicht von der vorigen Ausgabe. Einen Stärkeregler gibt es nicht: Ging eine Bearbeitung zu weit, hilft ein genauerer Satz, keine kleinere Zahl.
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-spicy-edit/edit",
"input": {
"image_url": "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.
