Qwen Image 2.1 API-Referenz
Offenes Modell mit 2K-Ausgabe und transparentem Hintergrund
Mit einem einzigen PopNow-API-Schlüssel rufst du Qwen Image 2.1 aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.
Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.
Auf einen Blick
- Hersteller
- Alibaba
- Ergebnis
- Bild
- Ab
- 3.6 Credits pro Bild ($0.036)
- Typische Dauer
- etwa 44 s
1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.
Bild erstellen
alibaba/qwen-image-2.1/text-to-image
Preis
| Option | Credits (pro Bild) | US-Dollar |
|---|---|---|
1k | 3.6 | $0.036 |
1.5k | 7.2 | $0.072 |
2k | 7.2 | $0.072 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the subject, composition, lighting, and any wording to render. |
aspect_ratioOptional | string | 1:1 | 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, … (+1) | Output aspect ratio. |
resolutionOptional | string | 1k | 1k, 1.5k, 2k | Output resolution tier. |
enable_prompt_expansionOptional | boolean | true | — | Rewrite the prompt into a fuller scene description before generating. On by default; turn it off to have the prompt followed word for word. |
backgroundOptional | string | opaque | opaque, transparent | opaque keeps a normal background; transparent returns the subject alone on a real alpha channel (needs output_format png or webp). |
output_formatOptional | string | jpeg | jpeg, png, webp | Container of the returned image. |
seedOptional | integer | — | 0 bis 2147483647 | Random seed for controlled comparisons. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
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: $(uuidgen)" \
-d '{
"model": "alibaba/qwen-image-2.1/text-to-image",
"input": {
"prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
"resolution": "1k"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Bild bearbeiten
alibaba/qwen-image-2.1/edit
Preis
| Option | Credits (pro Bild) | US-Dollar |
|---|---|---|
1k | 5.4 | $0.054 |
2k | 7.2 | $0.072 |
1.5k | 10.8 | $0.108 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the subject, composition, lighting, and any wording to render. |
image_urlsPflicht | array<string (uri)> | — | bis zu 10 Einträge | One to ten reference images. Each one you add raises the quote. |
mask_urlOptional | string (uri) | — | — | Optional black-and-white mask for local editing: white is the area to repaint, black is kept. Use it with exactly one reference image. |
aspect_ratioOptional | string | 1:1 | 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, … (+1) | Output aspect ratio. |
resolutionOptional | string | 1k | 1k, 1.5k, 2k | Output resolution tier. |
enable_prompt_expansionOptional | boolean | true | — | Rewrite the prompt into a fuller scene description before generating. On by default; turn it off to have the prompt followed word for word. |
backgroundOptional | string | opaque | opaque, transparent | opaque keeps a normal background; transparent returns the subject alone on a real alpha channel (needs output_format png or webp). |
output_formatOptional | string | jpeg | jpeg, png, webp | Container of the returned image. |
seedOptional | integer | — | 0 bis 2147483647 | Random seed for controlled comparisons. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "alibaba/qwen-image-2.1/edit",
"input": {
"prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "1k"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"