Einführung
Qwen Image 3.0 Text-zu-Bild setzt einen schriftlichen Brief in ein Bild pro Anfrage um. Sein besonderes Merkmal ist die Typografie: Zeichenfolgen in Anführungszeichen – ein Türanhänger, ein Barschild, eine Plakatüberschrift – werden als echter Text gerendert, nicht als buchstabenähnliche Textur.
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, Chinesisch oder Englisch, ohne Sprach-Flag. mindestens 1 Zeichen · höchstens 5000 Zeichen |
aspect_ratio | Nein | Komponiert den Frame vor der Generierung, statt hinterher zu beschneiden – wählen Sie also die Form, in der das Bild veröffentlicht wird. |
resolution | Nein | 1k oder 2k, Vorgabe 2k, und hier die einzige Preisvariante. Erzeugen Sie alles mit lesbarer Schrift in 2k; 1k ist für schnelle Layout-Skizzen, in denen nichts lesbar sein muss. |
num_outputs | Nein | Fest auf 1: Jede Anfrage liefert ein Bild. Für einen Kontaktbogen aus einem Briefing schicken Sie parallele Anfragen ohne Seed; jede wird einzeln bepreist und abgerechnet. |
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, außerhalb des Hauptprompts. Lohnt sich gegen Wasserzeichen, doppelte Gliedmaßen und verunglückte Buchstaben, wenn ein Frame Schrift trägt. höchstens 2000 Zeichen |
prompt_optimization_mode | Nein | Wie die Prompt-Erweiterung Ihr Briefing umschreibt, solange |
seed | Nein | Beim Ausprobieren weglassen, dann zieht jeder Aufruf seinen eigenen. Fixieren Sie ihn, sobald ein Frame funktioniert, und ändern Sie dann ein anderes Feld nach dem anderen. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.03 / Bild |
| $0.03 / Bild |
Anwendungsfälle
Mit einem schriftlichen Brief beginnen
Nutzen Sie diesen Modus, wenn es für das Bild noch keine Vorlage gibt und ein Teil des Wortlauts lesbar sein muss: ein Schild, ein Etikett, eine Überschrift. Wählen Sie das Format, in dem Sie veröffentlichen, lassen Sie die Auflösung auf 2k und setzen Sie jede Zeichenfolge im Prompt in einfache Anführungszeichen.
Figurensets und Modeserien
Stylingprompts, die andere APIs abweisen, laufen hier ohne Schalter. Fixieren Sie den Seed, der Ihnen die Figur gegeben hat, und ändern Sie pro Anfrage nur ein Detail – Kleidung, Licht oder Pose –, für ein stimmiges Set statt eines Haufens unzusammenhängender Ergebnisse.
Plakat- und Verpackungsentwürfe
Überschrift, Unterzeile und eine Rechtszeile, alle im Bild gerendert, in 2k und im Format, das die Platzierung tatsächlich nutzt. Nützlich, um ein Layout zu präsentieren, bevor eine Designerin echte Schrift über eine saubere Fläche setzt.
Szenenbilder für Hotellerie und Ausstattung
Hotelzimmer, Bars und Lobbys, in denen ein bestimmtes Schild korrekt lesbar sein muss: Türanhänger, Zimmernummern, Cocktailkarten, Neon über der Rückbar. Erzeugen Sie das Bild mit dem Wortlaut bereits an Ort und Stelle, statt nachträglich Schrift über ein Rendering zu montieren.
Prompt-Leitfaden und Praxistipps
Zuerst Format und Stufe wählen
aspect_ratio komponiert das Bild, statt es zuzuschneiden; wählen Sie also die Form, in der Sie veröffentlichen. Lassen Sie die Auflösung auf 2k, sobald das Bild Text enthält, und gehen Sie nur für Layout-Skizzen, in denen nichts lesbar sein muss, auf 1k.
Die Szene beschreiben und den Wortlaut wörtlich zitieren
Beschreiben Sie Motiv, Garderobe, Licht und Objektiv und setzen Sie dann jede exakte Zeichenfolge in einfache Anführungszeichen – jeweils rund acht Wörter. enable_prompt_expansion ist standardmäßig aktiv und schreibt detaillierte Prompts um; schalten Sie es ab, sobald Ihr Text eine präzise Bildbeschreibung ist.
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.
Editorial photograph, an adult woman sitting on a hotel bed in a navy satin slip dress, city lights blurred through the window behind her, a brass door hanger hanging in sharp foreground reading 'DO NOT DISTURB', warm tungsten bedside lamp, cinematic 35mm, shallow focus, moody blue and amber palette.
Genau diese Anfrage steht hinter dem veröffentlichten Standbild: eine Hotelszene in 3:4 auf der 2k-Stufe, der Text des Türanhängers im Prompt zitiert.
Das Ergebnis prüfen, bevor Sie iterieren
Kurze zitierte Zeichenfolgen sind der verlässliche Fall: ein Titel, ein Schild, ein Etikett, grob acht Wörter oder weniger pro Element. Fließtext in Absatzlänge zerfällt weiterhin in plausibel aussehenden Unsinn, und dichte kleine Schrift bricht auf der 1k-Stufe als Erstes – erzeugen Sie Typografie in 2k. Nicht-lateinische Schriften werden gerendert, lesen Sie sie aber Korrektur: Bei seltenen Zeichen ist das Modell selbstsicherer als treffsicher.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# 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.


















