PopNowAPI-Doku
Hauptinhalt

Qwen Image 2.1 Turbo API-Referenz

Schnelle Renderings in 8 Schritten, bis zu sechs pro Prompt

Mit einem einzigen PopNow-API-Schlüssel rufst du Qwen Image 2.1 Turbo 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
2.16 Credits pro Bild ($0.0216)
Typische Dauer
etwa 28 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-turbo/text-to-image

Preis

OptionCredits (pro Bild)US-Dollar
Standard2.16$0.0216

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 5.000 ZeichenDescribe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt.
aspect_ratioOptionalstring1:11: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.
resolutionOptionalstring2k1k, 1.5k, 2kOutput resolution tier. Every tier costs the same.
num_outputsOptionalinteger11 bis 6How many images to generate in one request (1 to 6). Billed per image returned.
enable_prompt_expansionOptionalbooleanfalse—Let the service rewrite and expand the prompt before generating. Off by default so the prompt is followed word for word.
enable_thinkingOptionalbooleantrue—Spend extra reasoning on the rewrite for better images, at the cost of a longer wait. Only works while prompt expansion is on.
prompt_optimization_modeOptionalstringdirectdirect, agentHow prompt expansion rewrites the brief: direct is a single pass that suits most prompts; agent is a multi-step rewrite with finer detail.
seedOptionalinteger—0 bis 2147483647Random 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.

POST /api/v1/jobs/createTask?wait=60
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-turbo/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",
    "num_outputs": 1
  }
}'

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.

GET /api/v1/jobs/recordInfo
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-turbo/edit

Preis

OptionCredits (pro Bild)US-Dollar
Standard2.16$0.0216

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 5.000 ZeichenDescribe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt.
image_urlsPflichtarray<string (uri)>—bis zu 10 EinträgeOne to ten source images, in the order you refer to them in the prompt (Image 1, Image 2 and so on).
aspect_ratioOptionalstring—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. Omit it to let the model choose a size from the source images.
resolutionOptionalstring2k1k, 1.5k, 2kOutput resolution tier. Every tier costs the same.
num_outputsOptionalinteger11 bis 6How many images to generate in one request (1 to 6). Billed per image returned.
enable_prompt_expansionOptionalbooleanfalse—Let the service rewrite and expand the prompt before generating. Off by default so the prompt is followed word for word.
enable_thinkingOptionalbooleantrue—Spend extra reasoning on the rewrite for better images, at the cost of a longer wait. Only works while prompt expansion is on.
seedOptionalinteger—0 bis 2147483647Random 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.

POST /api/v1/jobs/createTask?wait=60
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-turbo/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"
    ],
    "num_outputs": 1
  }
}'

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.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Weiter geht’s

Auf dieser Seite