获取任务详情

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

通过 taskId（路径参数）查询异步生成任务的状态与结果。请每隔几秒轮询本接口，直到 state 为 success 或 fail。

state 为以下之一：waiting、queuing、generating、success、fail
成功时，resultUrls 包含生成的媒体 URL（文本输出则为 resultText）
creditsConsumed 反映实际计费的成本；失败任务不计费
balance 是结算后的剩余积分余额

请求

认证

在 Authorization 请求头中提供你的 bearer token。

Authorization: Bearer <YOUR_API_KEY>

查询参数

taskIdstring (path)必填

由 POST /api/generate 返回的任务标识。

示例： task_12345678

响应

200 · 成功响应 — application/json

taskIdstring必填

任务标识

示例： task_12345678

statestring必填

waiting | queuing | generating | success | fail

示例： success

resultUrlsstring[]可选

state 为 success 时生成的媒体 URL

示例： ["https://.../out.jpg"]

resultTextstring可选

文本类模型的文本输出

creditsConsumedinteger必填

本任务实际计费的积分

示例： 5

failMsgstring可选

state 为 fail 时的失败信息

balanceinteger必填

你的剩余积分余额

示例： 1950

状态码

状态码	说明
200	成功 —— 请求已成功处理
400	请求错误 —— 参数不正确或缺失
401	未授权 —— 认证凭据缺失或无效
405	方法不允许 —— 不支持该请求方法
500	服务器错误 —— 发生意外错误，请重试

示例

请求 — cURL

cURL

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

响应 — 200

JSON

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