Task-Details abrufen

GEThttps://97ai.97claude.com/api/generate/{taskId}

Frage Status und Ergebnis einer asynchronen Generierungsaufgabe über ihre taskId (Pfadparameter) ab. Frage diesen Endpunkt alle paar Sekunden ab, bis state success oder fail ist.

state ist eines von: waiting, queuing, generating, success, fail
Bei Erfolg enthält resultUrls die generierten Medien-URLs (oder resultText für Textausgabe)
creditsConsumed spiegelt die tatsächlich berechneten Kosten wider; fehlgeschlagene Tasks werden nicht berechnet
balance ist dein verbleibendes Guthaben nach der Abrechnung

Anfrage

Autorisierung

Gib deinen Bearer-Token im Authorization-Header an.

Authorization: Bearer <YOUR_API_KEY>

Query-Parameter

taskIdstring (path)erforderlich

Die von POST /api/generate zurückgegebene Task-Kennung.

Beispiel: task_12345678

Antworten

200 · Erfolgsantwort — application/json

taskIdstringerforderlich

Task-Kennung

Beispiel: task_12345678

statestringerforderlich

waiting | queuing | generating | success | fail

Beispiel: success

resultUrlsstring[]optional

Generierte Medien-URLs, wenn state success ist

Beispiel: ["https://.../out.jpg"]

resultTextstringoptional

Textausgabe für textproduzierende Modelle

creditsConsumedintegererforderlich

Tatsächlich für diesen Task berechnete Credits

Beispiel: 5

failMsgstringoptional

Fehlermeldung, wenn state fail ist

balanceintegererforderlich

Dein verbleibendes Guthaben

Beispiel: 1950

Statuscodes

Code	Beschreibung
200	Erfolg — die Anfrage wurde erfolgreich verarbeitet
400	Ungültige Anfrage — Parameter sind falsch oder fehlen
401	Nicht autorisiert — Authentifizierungsdaten fehlen oder sind ungültig
405	Methode nicht erlaubt — die Anfragemethode wird nicht unterstützt
500	Serverfehler — ein unerwarteter Fehler ist aufgetreten, bitte erneut versuchen

Beispiele

Anfrage — cURL

cURL

curl -X GET "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Antwort — 200

JSON

{
  "taskId": "task_12345678",
  "state": "success",
  "resultUrls": ["https://example.com/generated.jpg"],
  "resultText": null,
  "creditsConsumed": 5,
  "failMsg": "",
  "balance": 1950
}