Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
aspect_ratio | Nein | Die Form des Bildes: breit, quadratisch oder hoch. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · Standardwert: 1:1 |
enable_prompt_expansion | Nein | Lässt das Modell einen kurzen Prompt mit Details ergänzen. Standardwert: true |
image_urls | Ja | Fotos zum Bearbeiten oder Kombinieren. Schreib im Prompt, was jedes beisteuert. |
negative_prompt | Nein | Was du nicht sehen willst. |
num_outputs | Nein | Wie viele Ergebnisse auf einmal entstehen. ≥ 1 · ≤ 1 · Standardwert: 1 |
prompt | Ja | Describe the subject, composition, lighting, and any text to render. |
resolution | Nein | Ausgabegröße. Größere Formate sind schärfer und kosten mehr. 1k · 2k · Standardwert: 2k |
seed | Nein | Dieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647 |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Bild | ≈ USD |
|---|---|---|
| resolution 1K | 6 | 0,06 $ |
| resolution 2K | 11,25 | 0,11 $ |
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Qwen Image 3.0 Pro API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model alibaba/qwen-image-3.0-pro/edit und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Qwen Image 3.0 Pro API
Was kostet die Qwen Image 3.0 Pro API?
Qwen Image 3.0 Pro gibt es ab 6 Credits (0,06 $) pro Bild – mit Bild bearbeiten, der günstigsten Aufgabe. Preise nach Option: 1K 6 Credits pro Bild, 2K 11,25 Credits pro Bild. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Qwen Image 3.0 Pro in der API?
Trag alibaba/qwen-image-3.0-pro/text-to-image für Bild erstellen; alibaba/qwen-image-3.0-pro/edit für Bild bearbeiten im Feld model von POST /jobs/createTask ein.
Wie unterscheidet sich Qwen Image 3.0 Pro von Qwen Image 3.0?
Gleiche Anfrageform, gleiche Felder, höhere Detailgrenze – am sichtbarsten bei mehrteiliger Typografie und bei feinem Material. Erkunden auf 3.0, ausliefern auf Pro; der Prompt muss dazwischen nicht umgeschrieben werden.
Wie viele Textelemente trägt ein Cover?
Drei oder vier kurze Zeichenfolgen sind der verlässliche Bereich: eine Titelzeile, eine Ausgabenzeile und ein oder zwei Coverzeilen. Zitieren Sie jede einzeln und sagen Sie, wo sie sitzt. Ganze Absätze Fließtext zerfallen weiterhin.
Welches Seitenverhältnis nimmt ein Cover?
3:4 oder 2:3. Beide werden von Anfang an für diese Form komponiert, und das ist nicht dasselbe wie ein beschnittenes Quadrat – Motiv und Schrift sind für das verlangte Format angelegt.
Kann ich ein vorhandenes Cover bearbeiten, statt es neu zu erzeugen?
Ja, am image-to-image-Endpunkt. Geben Sie den Frame in image_urls mit, zitieren Sie alten und neuen Wortlaut und benennen Sie alles, was identisch bleiben muss – Pose, Ausschnitt, Farblook.
Bekomme ich mehrere Varianten eines Layouts?
Nicht in einem Aufruf: num_outputs ist fest auf 1 gesetzt. Schicken Sie dasselbe Briefing als parallele Anfragen ohne Seed. Jede liefert ein Bild und wird einzeln bepreist, und weil sich nur der Zug unterscheidet, bleiben die Lesarten direkt vergleichbar.
Welche Limits hat die Qwen Image 3.0 Pro API?
Auflösungen: 1K · 2K; Seitenverhältnisse: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Referenzbilder: 3; Prompt-Länge (Zeichen): 5,000; Größter Upload: 10 MB. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Qwen Image 3.0 Pro testen, ohne Code zu schreiben?
Ja. Der Playground führt Qwen Image 3.0 Pro mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.
Alle Qwen Image-Modelle
Qwen Image 3.0 nimmt exakt dieselben Prompts für etwas weniger und ist der Ort zum Ausprobieren. Pro hat die höhere Obergrenze bei Typografie und feinen Materialien.
- Qwen Image 2.1 Pro APIBis zu sechs detailreiche 2K-Bilder aus einem PromptAb 6 Credits pro Bild
- Qwen Image 2.1 Turbo APISchnelle Renderings in 8 Schritten, bis zu sechs pro PromptAb 3 Credits pro Bild
- Qwen Image 2.1 APIOffenes Modell mit 2K-Ausgabe und transparentem HintergrundAb 4 Credits pro Bild
- Qwen Image 2.1 LoRA APIQwen-Image-2.1-Bilder und -Edits mit bis zu drei eigenen LoRAsAb 5 Credits pro Bild
- Qwen Image 3.0 Pro APIFeine Typografie plus lebensechte Haut, Stoffe und GlasAb 6 Credits pro Bild
- Qwen Image 3.0 APISchilder und Headlines lesbar ins Bild gesetztAb 5 Credits pro Bild
- Qwen Image 2 APIEinfach: Bilder aus Text und Edits an einem FotoAb 6 Credits pro Bild
- Qwen Image 2512 LoRA APIQwen Image 2512: Renderings und Edits mit eigenen LoRAsAb 5 Credits pro Bild
- Qwen Image Edit 2509 LoRA APIQwen-Edits mit mehreren Fotos, lädt eigene LoRAsAb 5 Credits pro Bild
- Qwen Image 1.0 LoRA APIDas ursprüngliche Qwen-Image, saubere Schrift und eigene LoRAsAb 5 Credits pro Bild

