Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
seed | Nein | Dieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647 |
prompt | Ja | Describe the subject, composition, lighting, and any wording to render. |
background | Nein | Hintergrund behalten, entfernen oder ersetzen. opaque · transparent · Standardwert: opaque |
resolution | Nein | Ausgabegröße. Größere Formate sind schärfer und kosten mehr. 1k · 1.5k · 2k · Standardwert: 1k |
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 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 · Standardwert: 1:1 |
output_format | Nein | Dateiformat des Ergebnisses. jpeg · png · webp · Standardwert: jpeg |
enable_prompt_expansion | Nein | Lässt das Modell einen kurzen Prompt mit Details ergänzen. Standardwert: true |
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 | 3,6 | 0,036 $ |
| resolution 1.5K | 7,2 | 0,072 $ |
| resolution 2K | 7,2 | 0,072 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 4 Credits pro Bild (0,04 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Qwen Image 2.1 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-2.1/text-to-image 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-2.1/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "1k",
"background": "opaque",
"output_format": "jpeg"
}
}'
# 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 2.1 API
Was kostet die Qwen Image 2.1 API?
Qwen Image 2.1 gibt es ab 4 Credits (0,04 $) pro Bild – mit Bild erstellen, der günstigsten Aufgabe. Preise nach Option: 1K 3,6 Credits pro Bild, 1.5K 7,2 Credits pro Bild, 2K 7,2 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 2.1 in der API?
Trag alibaba/qwen-image-2.1/text-to-image für Bild erstellen; alibaba/qwen-image-2.1/edit für Bild bearbeiten im Feld model von POST /jobs/createTask ein.
Ist das das Modell, das Alibaba gerade als Open Source freigegeben hat?
Ja. Qwen-Image-2.1 wurde am 21. September 2026 als Open Weights freigegeben und ging hier am selben Tag live – als gehostete API, ohne Einrichtung, ohne GPU und ohne Gewichte zum Herunterladen.
Kann ich nur einen Teil eines Bildes bearbeiten statt des ganzen Frames?
Ja, und wir haben es verifiziert. Markieren Sie die Fläche im Referenzbild – ein gezeichneter Kreis oder ein übermalter Fleck – und beschreiben Sie die Änderung darin, inklusive der Anweisung, die Markierung zu entfernen. In unserem Test landete die Bearbeitung exakt innerhalb der markierten Region, und der Rest des Frames blieb unangetastet.
Wie viele Referenzbilder nimmt die Bildbearbeitung?
Eins bis zehn. Benennen Sie im Prompt, was jedes davon beisteuert, denn das Modell verteilt die Rollen nicht von selbst. Jede zusätzliche Referenz hebt den Kostenvoranschlag – schicken Sie also nur die, die auch arbeiten.
Liefert ein fester seed dasselbe Bild?
Nein. Wir haben denselben Prompt zweimal mit demselben seed geschickt und zwei verschiedene Frames bekommen. Nutzen Sie den seed, um eine Serie in der Anmutung zusammenzuhalten, und bewahren Sie das zurückgegebene Asset auf, wenn Sie genau dieses Bild noch einmal brauchen.
Gibt es einen negativen Prompt?
In dieser Familie nicht. Ausschlüsse gehören in den Hauptprompt – er fasst 5.000 Zeichen und damit reichlich Platz, um sowohl zu sagen, was im Bild sein soll, als auch, was nicht.
Welche Limits hat die Qwen Image 2.1 API?
Auflösungen: 1K · 1.5K · 2K; Seitenverhältnisse: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Prompt-Länge (Zeichen): 5,000. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Qwen Image 2.1 testen, ohne Code zu schreiben?
Ja. Der Playground führt Qwen Image 2.1 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 2.1 Turbo ist schneller und günstiger für Entwürfe, Pro bietet feinere Porträtdetails. Das Standardmodell liegt dazwischen, mit maskierten Bearbeitungen und transparenten Freistellern.
- 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

