Get Task Details

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

Query the status and result of an asynchronous generation task by its taskId (path parameter). Poll this endpoint every few seconds until state is success or fail.

state is one of: waiting, queuing, generating, success, fail
On success, resultUrls contains the generated media URLs (or resultText for text output)
creditsConsumed reflects the actual cost billed; failed tasks are not billed
balance is your remaining credit balance after settlement

Request

Authorization

Provide your bearer token in the Authorization header.

Authorization: Bearer <YOUR_API_KEY>

Query Params

taskIdstring (path)required

The task identifier returned by POST /api/generate.

Example: task_12345678

Responses

200 · SuccessResponse — application/json

taskIdstringrequired

Task identifier

Example: task_12345678

statestringrequired

waiting | queuing | generating | success | fail

Example: success

resultUrlsstring[]optional

Generated media URLs when state is success

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

resultTextstringoptional

Text output for text-producing models

creditsConsumedintegerrequired

Credits actually billed for this task

Example: 5

failMsgstringoptional

Failure message when state is fail

balanceintegerrequired

Your remaining credit balance

Example: 1950

Status Codes

Code	Description
200	Success — request has been processed successfully
400	Bad Request — parameters are incorrect or missing
401	Unauthorized — authentication credentials missing or invalid
405	Method Not Allowed — request method is not supported
500	Server Error — an unexpected error occurred, please retry

Examples

Request — cURL

cURL

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

Response — 200

JSON

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