Einführung
Was dieser Endpunkt leistet
Qwen Image 2.1 Pro Bildbearbeitung überarbeitet Ihre Quellbilder anhand einer schriftlichen Anweisung und liefert mit Alibabas gehosteter Pro-Stufe von Qwen Image 2.1 ein bis sechs neue Bilder. Unsere Bearbeitungen dauerten von Anfang bis Ende 39 bis 48 Sekunden.
Eingaben
image_urls trägt ein bis zehn Referenzen, in der Reihenfolge, in der Sie sie Image 1, Image 2 und so weiter nennen. prompt ist die Anweisung. Lassen Sie aspect_ratio weg, um die Form der Vorlage bei etwa 2K zu behalten, oder setzen Sie es zusammen mit resolution für eine feste Größe. num_outputs fordert ein bis sechs Ergebnisse an, enable_prompt_expansion (standardmäßig aus) und enable_thinking steuern Alibabas Umschreibung, und seed stabilisiert eine Serie.
Inhalte
Kein Filter der Plattform. Bei ausgeschalteter Erweiterung kam jede getestete Bearbeitung wie gewünscht zurück, auf allen fünf Intensitätsstufen von Mild bis Maximal.
| Feld | Wert |
|---|---|
| Eingabe | Bild |
| Ausgabe | Bild |
| Status auf SpicyAPI | Live: Text zu Bild und Bildbearbeitung |
| Basiert auf | Qwen Image 2.1, als Alibabas gehostete Pro-Stufe |
| Bilder pro Anfrage | 1 bis 6, berechnet pro geliefertem Bild |
| Preis | Ein fester Preis pro Bild auf den Stufen 1k, 1.5k und 2k; das Live-Angebot steht auf dieser Seite |
| Seitenverhältnisse | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| 2K-Größen | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Bearbeitung | 1 bis 10 Referenzbilder; ohne Seitenverhältnis folgt die Ausgabe der Vorlage bei etwa 2K |
| Prompt | Bis zu 5.000 Zeichen; kein Negativ-Prompt, schreiben Sie Ausschlüsse also in den Prompt |
| Prompt-Erweiterung | Standardmäßig aus; eingeschaltet direct- oder agent-Umschreibung, mit optionalem Denkdurchgang |
| Gemessene Wartezeit | 14 bis 43 Sekunden für Text zu Bild, 39 bis 48 Sekunden für Bearbeitungen, in unseren Läufen |
| Inhaltsrichtlinie | Unzensiert: kein Filter der Plattform, kein Reifegrad-Flag |
| Gewichte | Nicht veröffentlicht; Alibaba bietet Pro als gehostete API an |
Wichtige Funktionen und Highlights
Ein Titelkopf, der gleich beim ersten Mal stimmt
Setzen Sie die Wörter in Anführungszeichen und sagen Sie, wohin sie gehören. "AFTER DARK" quer oben und die kleine Coverzeile darunter kamen Buchstabe für Buchstabe zurück, in beiden Bildern der Anfrage.
Zwei Porträts, ein Kerzentisch
Ein Mann und eine Frau, getrennt fotografiert und als Image 1 und Image 2 benannt, landen an einem Tisch auf einer Weinterrasse, beide Gesichter weiterhin wiedererkennbar und ihr Kleid wie verlangt geändert.
Pro oder Turbo, ohne eine Zeile umzuschreiben
Pro und Turbo lesen auf SpicyAPI dieselben Felder, ein Prompt, der auf dem einen funktioniert, lässt sich also unverändert an das andere senden. Entwerfen Sie schnell auf Turbo und behalten Sie die wichtigen Bilder auf Pro, oder umgekehrt.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Die Bearbeitungsanweisung, bis zu 5.000 Zeichen. Sagen Sie zuerst, was sich ändert, dann was bleiben muss: Gesicht, Haare, Pose, Licht. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_urls | Ja | Ein bis zehn Quellbilder, in der Reihenfolge, in der Sie sie nennen. Die Zahl der Referenzen ändert den Preis nicht. mindestens 1 Einträge · höchstens 10 Einträge |
aspect_ratio | Nein | Lassen Sie es weg, und das Ergebnis behält die Form Ihrer Vorlage bei etwa 2K. |
resolution | Nein | 1k, 1.5k oder 2k, nur wirksam, wenn Sie ein Seitenverhältnis setzen. Jede Stufe kostet pro Bild dasselbe. |
num_outputs | Nein | Ein bis sechs Ergebnisse aus derselben Anweisung in einer Anfrage. Jedes gelieferte Bild wird berechnet. |
enable_prompt_expansion | Nein | Standardmäßig aus, sodass Ihre Anweisung das Modell genau so erreicht, wie sie geschrieben ist. Standardwert: |
enable_thinking | Nein | Verwendet zusätzliche Überlegung auf die Umschreibung, auf Kosten einer längeren Wartezeit. Wirkt nur, solange die Prompt-Erweiterung eingeschaltet ist. Standardwert: |
seed | Nein | Stabilisiert einen Wurf, damit Sie jeweils eine Änderung vergleichen können. Ein pixelgleiches Bild ist nicht garantiert. |
Preis
$0.036 / Bild
Anwendungsfälle
Unzensierte Bildarbeit
SpicyAPI setzt keinen Inhaltsfilter vor Pro. Bei ausgeschalteter Prompt-Erweiterung kamen unsere Tests auf jeder gefahrenen Intensitätsstufe, von Mild bis Maximal, mit weiblichen wie männlichen Motiven wie geschrieben zurück.
Cover und Plakate mit exaktem Wortlaut
Alibaba nennt für Pro eine verbesserte Typografie. Setzen Sie Titelkopf und Coverzeile in Anführungszeichen, sagen Sie, wo jede sitzt, und beschreiben Sie das Foto: Unser Magazincover kam mit beiden Zeilen exakt buchstabiert zurück, in beiden Bildern der Anfrage.
Eine Figur über eine ganze Serie
Erzeugen Sie eine Figur, senden Sie das Bild dann als Referenz zurück und ändern Sie Outfit, Raum oder Licht in getrennten Durchgängen. Jede Bearbeitung startet von Ihrem freigegebenen Bild statt von einem neuen Wurf, sodass das Gesicht sich durch die Serie trägt.
Paare aus zwei Porträts
Senden Sie zwei Porträts als Image 1 und Image 2 und beschreiben Sie die Szene, die sie teilen. In unserem Test landeten ein Mann und eine Frau, getrennt fotografiert, an einem Kerzentisch auf einer Weinterrasse, beide weiterhin wiedererkennbar.
Stimmungsvolle Porträts und Licht
Alibaba nennt Porträtbeleuchtung und feines Detail als Stärken von Pro. Benennen Sie eine Lichtquelle und wohin sie fällt, eine Sturmlampe, ein hohes Fenster, eine Wandleuchte, und das Bild baut sich um sie auf.
Viele Entwürfe für einen Treffer
Bis zu sechs Bilder pro Aufruf zum festen Preis ergeben eine günstige Auswahl. Erkunden Sie Kleidung, Pose und Licht in einer Anfrage, behalten Sie das Bild, das funktioniert, und stecken Sie Ihre Bearbeitungen in dieses eine.
Prompt-Leitfaden und Praxistipps
Wenn es auf die Formulierung ankommt, die Prompt-Erweiterung ausgeschaltet lassen
Die Erweiterung gibt Ihren Prompt an Alibabas Umschreiber, bevor das Bild entsteht, und diese Umschreibung kann einen gewagten Auftrag abschwächen. Hier ist sie standardmäßig aus, und jeder Inhaltstest, den wir ohne sie gefahren haben, kam wie geschrieben zurück. In unserem einen Pro-Lauf mit eingeschalteter Erweiterung kam ein Prompt, den die offizielle App blockieren würde, trotzdem durch. Lassen Sie sie aber immer aus, wenn es auf den genauen Wortlaut ankommt.
Für kurze Alltags-Prompts einschalten
Ein Briefing aus sechs Wörtern bekommt mit eingeschalteter Erweiterung eine ausführlichere Szene. direct schreibt in einem Durchgang um und passt zu den meisten Prompts; agent schreibt in mehreren Schritten um, für ein feineres Ergebnis. Der Denkmodus investiert zusätzliche Überlegung in diese Umschreibung und kostet Zeit; bei ausgeschalteter Erweiterung bewirkt er nichts.
2K nehmen, es kostet dasselbe
Jede Stufe kostet pro Bild dasselbe, deshalb ist 2K die Voreinstellung und die vernünftige Wahl. Gehen Sie nur auf 1k, wenn Sie eine kleinere Datei oder eine etwas schnellere Antwort wollen.
Mehrere Bilder auf einmal anfordern
Setzen Sie
num_outputsvon 1 bis 6, um Varianten eines Prompts in einem Aufruf zu bekommen. Jedes Bild, das zurückkommt, wird berechnet, sechs Bilder kosten also das Sechsfache von einem. So finden Sie am günstigsten eine Pose oder Komposition, die Ihnen gefällt, bevor Sie mit dem Bearbeiten beginnen.Beim Bearbeiten erst die Änderung, dann die Behalten-Liste
Schreiben Sie zuerst das eine, was sich ändern soll, dann alles, was bleiben muss: „Ändere ihr Samtkleid in ein elfenbeinfarbenes Abendkleid; Gesicht, Haare und Ausdruck beibehalten.“ Benennen Sie Referenzen mit ihrer Nummer. In unserem Test mit zwei Porträts blieben bei „dem Mann aus Bild 1 und der Frau aus Bild 2“ an einem kerzenbeleuchteten Tisch beide Gesichter in einem Bild erkennbar.
Wörter, die erscheinen sollen, in Anführungszeichen setzen
Setzen Sie den genauen Wortlaut in Anführungszeichen und sagen Sie, wohin er gehört. Unser Magazincover, "AFTER DARK" oben quer und "THE SILK ISSUE · NO. 07" in kleinen Buchstaben darunter, kam Buchstabe für Buchstabe zurück. Halten Sie jede Zeile kurz und prüfen Sie sie in voller Größe, bevor Sie veröffentlichen.
Den Prompt in fester Reihenfolge schreiben
Motiv, Kleidung, Pose, Licht, Objektiv und Palette, in schlichten Sätzen. Nennen Sie die Lichtquelle und ihre Richtung (eine Öllampe links, ein rotierender Strahl hinter ihr) statt eines Stimmungsworts. Bei ausgeschalteter Erweiterung zeichnet Pro, was Sie schreiben, und füllt keine Lücken für Sie.
Einführung
Qwen Image 2.1 Pro Bildbearbeitung verändert ein vorhandenes Bild anhand einer Anweisung in einfacher Sprache. Pro ist die gehostete Stufe von Alibabas Qwen Image 2.1, das Generierung und Bearbeitung in einem Modell vereint; Alibaba nennt Bearbeitung mit bis zu zehn Referenzen, lokale Edits, die Personen und Produkte intakt lassen, sowie verbesserte Porträtbeleuchtung und feines Detail.
Auf SpicyAPI ist sie live. Eine Anfrage nimmt ein bis zehn Referenzen und liefert ein bis sechs Ergebnisse zu einem festen Preis pro Bild, ohne Inhaltsfilter vor dem Modell. Jedes Beispiel auf dieser Seite wurde mit Pro und dem gezeigten Prompt erzeugt.
Den Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Ein oder mehrere Bilder zum Ändern | Qwen Image 2.1 Pro Bildbearbeitung |
| Ein schriftliches Briefing, sonst nichts | Qwen Image 2.1 Pro Text zu Bild |
Was wir gemessen haben
Tempo
39 bis 48 Sekunden pro Bearbeitung von Anfang bis Ende in unseren Läufen, darunter zwei Ergebnisse aus zwei Referenzen in einem Aufruf.
Form
Ohne Seitenverhältnis kam ein 2:3-Porträt als 2:3-Bild bei etwa 2K zurück (1664 × 2496). Setzen Sie ein Seitenverhältnis, wenn Sie eine feste Größe brauchen.
Inhalte
Bei ausgeschalteter Prompt-Erweiterung, dem Standard, kam jede getestete Bearbeitung wie gewünscht zurück, auf allen fünf Intensitätsstufen von Mild bis Maximal. Keine einzige Bearbeitung wurde abgelehnt.
Zwei Referenzen
Ein Mann und eine Frau, getrennt fotografiert, kamen nebeneinander an einem Kerzentisch zurück, beide wiedererkennbar, ihr Outfit wie verlangt geändert.
Pro oder Turbo beim Bearbeiten
| Pro | Turbo | |
|---|---|---|
| Was es ist | Alibabas gehostete Pro-Stufe | 8-Schritt-Checkpoint |
| Gewichte | Nicht veröffentlicht | Offen, Qwen Research License |
| Ergebnisse pro Anfrage | 1 bis 6 | 1 bis 6 |
| Preis pro zusätzlicher Referenz | Keiner | Keiner |
| Preis pro Bild | Höher | Niedriger |
| Inhaltsfilter | Keiner | Keiner |
Die Anfrage ist dieselbe, Sie können also eine Anweisung auf beiden laufen lassen und das Ergebnis behalten, das Ihnen besser gefällt.
Prompt-Leitfaden & Profi-Tipps
Erst die Änderung, dann was bleibt
„Ändere ihr Samtkleid in ein elfenbeinfarbenes Abendkleid; Gesicht, Haare und Ausdruck beibehalten“ ist eine Bearbeitung. „Mach es besser“ ist ein erneuter Wurf.
Jede Referenz benennen
Das Modell teilt Referenzen nicht von selbst Rollen zu. Geben Sie an, welches Bild die Person ist, welches das Kleidungsstück und welches der Ort.
Erweiterung ausgeschaltet lassen
Die Umschreibung kann Ihre Anweisung abschwächen, bevor das Modell sie sieht. Ausgeschaltet erreicht die Anweisung das Modell wie geschrieben.
Eine Änderung pro Durchgang
Eine einzelne Änderung lässt sich leicht beurteilen. Bei fünf gleichzeitigen ist kaum zu erkennen, welche Anweisung Gesicht oder Hände verschoben hat.
Nach einigen Edits zum Original zurückkehren
Gesichter können über eine lange Kette von Edits abdriften. Kehren Sie zu Ihrem ersten freigegebenen Bild zurück, wenn Details sich zu verschieben beginnen.
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.1-pro/edit",
"input": {
"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.
