Z-Image Base LoRA API-Referenz
Z-Image Base mit bis zu drei eigenen LoRAs
Mit einem einzigen PopNow-API-Schlüssel rufst du Z-Image Base LoRA 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 21 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/z-image-base-lora/text-to-image
Preis
| Option | Credits (pro Bild) | US-Dollar |
|---|---|---|
Standard | 2.16 | $0.0216 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the subject, clothing, place and light in sentences. Put a LoRA trigger phrase first. |
aspect_ratioOptional | string | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 | Output aspect ratio. |
lorasOptional | array<object> | [] | bis zu 3 Einträge | Up to three LoRA weight files trained for Z-Image Base, each with its own strength. |
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/z-image-base-lora/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"
}
}'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/z-image-base-lora/edit
Preis
| Option | Credits (pro Bild) | US-Dollar |
|---|---|---|
Standard | 2.16 | $0.0216 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the whole image you want back, not just the change. |
image_urlPflicht | string (uri) | — | — | Source image. The result keeps its aspect ratio. |
resolutionOptional | string | 1k | 1k, 1.5k | Length of the output's long side: 1k is 1024 pixels, 1.5k is 1536. The source's aspect ratio is kept. |
strengthOptional | number | 0.7 | 0 bis 1 | How far to move away from the source, from 0 to 1. |
lorasOptional | array<object> | [] | bis zu 3 Einträge | Up to three LoRA weight files trained for Z-Image Base, each with its own strength. |
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_url 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/z-image-base-lora/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_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'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"