Z-Image Plus Pro API

Name: Z-Image Plus Pro API
SKU: alibaba/z-image-plus-pro/text-to-image
Price: 0.019 USD
Availability: InStock

von Alibaba

Z-Image in exakten eigenen Größen bis 2560 px

alibaba/z-image-plus-pro/text-to-image

Bild erstellen

Du rufst es mit dem Modellnamen alibaba/z-image-plus-pro/text-to-image über POST /jobs/createTask auf, ab 0,019 $.

Modellnamealibaba/z-image-plus-pro/text-to-image

EndpunktPOST https://api.popnow.ai/api/v1/jobs/createTask

# 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/z-image-plus-pro/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
  }
}'

# 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"

// Node 18+ (or any runtime with fetch). Keep the API key on your server.
const BASE = "https://api.popnow.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function call(path, init = {}) {
  const res = await fetch(BASE + path, { ...init, headers: { ...headers, ...init.headers } });
  const body = await res.json();
  if (body.code !== 200) throw new Error(`${body.code} ${body.msg}`);
  return body.data;
}

const { taskId } = await call("/jobs/createTask", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    "model": "alibaba/z-image-plus-pro/text-to-image",
    "input": {
      "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
    }
  }),
});

// Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
let task;
for (let delay = 2000; ; delay = Math.min(delay * 1.5, 15000)) {
  await sleep(delay);
  task = await call(`/jobs/recordInfo?taskId=${taskId}`);
  const copying = (task.output?.assets ?? []).some((a) => a.pending && !a.unavailable);
  if (["succeeded", "failed", "canceled", "expired"].includes(task.state) && !copying) break;
}
if (task.state !== "succeeded") throw new Error(`${task.state}: ${task.errorMessage ?? "no detail"}`);

// Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for (const asset of task.output.assets) console.log(asset.url);

import os, time, uuid, requests

BASE = "https://api.popnow.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}


def call(method, path, **kwargs):
    body = requests.request(method, BASE + path, headers={**HEADERS, **kwargs.pop("headers", {})}, timeout=30, **kwargs).json()
    if body["code"] != 200:
        raise RuntimeError(f'{body["code"]} {body["msg"]}')
    return body["data"]


task_id = call(
    "POST",
    "/jobs/createTask",
    headers={"Idempotency-Key": str(uuid.uuid4())},  # reuse it if you retry
    json={
        "model": "alibaba/z-image-plus-pro/text-to-image",
        "input": {
            "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
        }
    },
)["taskId"]

# Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
delay = 2.0
while True:
    time.sleep(delay)
    task = call("GET", "/jobs/recordInfo", params={"taskId": task_id})
    assets = (task.get("output") or {}).get("assets") or []
    copying = any(a.get("pending") and not a.get("unavailable") for a in assets)
    if task["state"] in ("succeeded", "failed", "canceled", "expired") and not copying:
        break
    delay = min(delay * 1.5, 15.0)

if task["state"] != "succeeded":
    raise RuntimeError(f'{task["state"]}: {task.get("errorMessage", "no detail")}')

# Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for asset in assets:
    print(asset["url"])

Der input ist aus dem Schema unten gebaut und besteht die Prüfung so, wie er dasteht. Ersetz Prompt und Links durch deine eigenen.

Preis

Option	USD pro Bild
Standard	0,019 $

Abrechnung in USD · Alle Optionen und Preise: GET /models/alibaba/z-image-plus-pro/text-to-image

Parameter

Diese Felder stammen aus demselben Schema, gegen das wir jede Anfrage prüfen. Nicht aufgeführte Felder werden abgelehnt.

promptstringPflicht
Describe the image to generate.
Bereich
1 – … chars
widthintegerOptional
Output image width in pixels.
Standardwert
1024
Bereich
256 – 2560
heightintegerOptional
Output image height in pixels.
Standardwert
1024
Bereich
256 – 2560
enable_prompt_expansionbooleanOptional
Lässt das Modell einen kurzen Prompt mit Details ergänzen.
Standardwert
false
seedintegerOptional
Dieselbe Zahl liefert ein wiederholbares Ergebnis.
Bereich
0 – 2147483647

Rohes JSON-Schema

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "Random seed; zero requests a random seed."
    },
    "width": {
      "type": "integer",
      "default": 1024,
      "maximum": 2560,
      "minimum": 256,
      "description": "Output image width in pixels."
    },
    "height": {
      "type": "integer",
      "default": 1024,
      "maximum": 2560,
      "minimum": 256,
      "description": "Output image height in pixels."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "Describe the image to generate."
    },
    "enable_prompt_expansion": {
      "type": "boolean",
      "default": false,
      "description": "Expand the prompt before generation."
    }
  },
  "additionalProperties": false
}

Antworten, Polling und Callbacks

Alle Modelle funktionieren gleich: Task anlegen, dann pollen oder auf den Callback warten.

Erst den Preis prüfen

cURL

curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/z-image-plus-pro/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
  }
}'

Sende vor dem Start denselben Anfrage-Body an POST /jobs/quote, um die geschätzten und maximalen Kosten in USD zu sehen. Die Preisabfrage führt keine Aufgabe aus und belastet dein Guthaben nicht.

Angenommen

HTTP

HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 bedeutet angenommen: Der USD-Höchstbetrag bleibt bis zur Abrechnung reserviert. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.

Status abfragen

cURL

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

Frag alle paar Sekunden mit wachsendem Abstand ab und hör auf, sobald state succeeded, failed, canceled oder expired ist.

Fertiger Task

JSON

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "alibaba/z-image-plus-pro/text-to-image",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.png?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "image/png",
          "width": 1024,
          "height": 1024
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Lad über die url vor expiresAt herunter. Später einen frischen Link nötig? Frag POST /common/download-url.

Callback prüfen

Node.js

import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Mit gesetzter callBackUrl schicken wir dir den fertigen Task. Prüf die Signatur am rohen Body, bevor du ihm vertraust.

Lokale Datei schicken

cURL

curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Öffentliche https-Links funktionieren direkt. Lokale Dateien laufen vorher über upload-url und commit.

Über Z-Image Plus Pro

Z-Image in exakten eigenen Größen bis 2560 px.

Du rufst es mit dem Modellnamen alibaba/z-image-plus-pro/text-to-image über POST /jobs/createTask auf, ab 0,019 $.

Anfrageparameter

Parameter	Pflicht	Beschreibung
`seed`	Nein	Dieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647
`width`	Nein	Output image width in pixels. ≥ 256 · ≤ 2560 · Standardwert: 1024
`height`	Nein	Output image height in pixels. ≥ 256 · ≤ 2560 · Standardwert: 1024
`prompt`	Ja	Describe the image to generate.
`enable_prompt_expansion`	Nein	Lässt das Modell einen kurzen Prompt mit Details ergänzen. Standardwert: false

Preise

Die Preise sind in USD angegeben. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.

Option	USD pro Bild
Standard	0,019 $

Sende vor dem Start denselben Anfrage-Body an POST /jobs/quote, um die geschätzten und maximalen Kosten in USD zu sehen. Die Preisabfrage führt keine Aufgabe aus und belastet dein Guthaben nicht.

API-Schnellstart

Die Z-Image Plus Pro 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-. API-Aufrufe nutzen dein separates Guthaben in US-Dollar.
Anfrage senden. Sende POST /jobs/createTask mit model alibaba/z-image-plus-pro/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/z-image-plus-pro/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
  }
}'

# 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 Z-Image Plus Pro API

Was kostet die Z-Image Plus Pro API?

Z-Image Plus Pro kostet 0,019 $ pro Bild. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.

Wie lautet der Modellname von Z-Image Plus Pro in der API?

Trag alibaba/z-image-plus-pro/text-to-image für Bild erstellen im Feld model von POST /jobs/createTask ein.

Mehr zu Z-Image Plus Pro

Doku: Modell-ID und Eingabeschema von Z-Image Plus Pro in der API-Doku PopNow API Schnellstart: deine erste Anfrage in fünf Minuten Anleitung zur Bildgenerierung mit der PopNow API Webhooks: Z-Image Plus Pro-Ergebnisse ohne Polling erhalten