Z-Image

Z-Image-Modelle werden über eine einheitliche, asynchrone Job-API aufgerufen. Starte einen Task mit POST /api/generate und frage dann GET /api/generate/{taskId} ab, bis er fertig ist. Diese Familie stellt 1 Endpunkt bereit.

Überblick

Jeder Endpunkt teilt sich dieselbe Hülle — nur model und die input-Felder ändern sich. Führe einen beliebigen im Playground des Modell-Markts aus.

Authentifizierung

Erstelle einen API-Schlüssel unter /api-keys und sende ihn als Bearer-Token. Anfragen aus dem Browser bei angemeldeter Sitzung funktionieren auch über das Session-Cookie.

Authorization: Bearer <YOUR_API_KEY>

Task erstellen

POST

POST https://97ai.97claude.com/api/generate

Body: { "model": "<slug>", "input": { … } }

Antwort: { "taskId": "<id>", "state": "waiting" }

Ergebnis abfragen

GET

GET https://97ai.97claude.com/api/generate/<taskId>

Antwort: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asynchron

Ein 200 von „Task erstellen“ bedeutet nur, dass der Task angenommen wurde — nicht, dass er fertig ist. Frage diesen Endpunkt ab, bis state zu success oder fail wird. Fehlgeschlagene Tasks werden nicht berechnet.

Endpunkte

Modell	Task	model slug
Z Image	Text to Image	z-image/z-image

Z Image · Text to Image

POSTText to Imagez-image/z-image

input-Felder

promptstringerforderlich

Text prompt describing the desired output.

aspect_ratiostringoptional

Output aspect ratio, e.g. "1:1", "16:9".

Beispiel

cURL

curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image/z-image",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'