Z-Image API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du Z-Image 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: 1.5 Credits pro Bild ($0.015)
Typische Dauer: etwa 11 s
Modell-IDs: alibaba/z-image-turbo/text-to-image

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/z-image-turbo/text-to-image

Preis

Option	Credits (pro Bild)	US-Dollar
`Standard`	1.5	$0.015
`enable_prompt_expansion = true`	2.4	$0.024

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`prompt`Pflicht	`string`	—	bis zu 1.000 Zeichen	Describe the image to generate: subject, composition, style, and lighting.
`aspect_ratio`Optional	`string`	`1:1`	1:1, 4:3, 3:4, 16:9, 9:16	Aspect ratio of the generated image.
`enable_prompt_expansion`Optional	`boolean`	`false`	—	Expand the prompt into a fuller description before generating. Requests with it on are billed at the prompt-expansion rate.
`output_format`Optional	`string`	`png`	png	File format of the returned image.
`seed`Optional	`integer`	—	0 bis 2147483647	Random seed for controlled comparisons. Omit it to let each run pick its own.

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/z-image-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",
    "enable_prompt_expansion": false
  }
}'

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"