按 task ID 查询任务、子 job 和生成资产。
GET /api/generations/{taskId}

示例

curl "$CUTAI_BASE_URL/api/generations/tsk_xxx" \
  -H "Authorization: Bearer $CUTAI_API_KEY"

状态

状态说明
queued已入队,等待服务端调度
submitted已提交给模型供应商
completed至少一个子 job 成功
failed所有子 job 都失败,积分已退回

响应

{
  "task": {
    "id": "tsk_xxx",
    "status": "completed",
    "assets": [
      {
        "id": "ast_xxx",
        "publicUrl": "https://..."
      }
    ],
    "jobs": [
      {
        "id": "job_xxx",
        "batchIndex": 1,
        "status": "completed",
        "creditCost": 20
      }
    ]
  },
  "billing": {
    "taskCreditCost": 40,
    "refundedCredits": 0,
    "netCreditCost": 40,
    "currentBalanceCredits": 960
  }
}
billing.currentBalanceCredits 是当前 API Key 所属账户的实时剩余积分。refundedCredits 统计已失败并退回的子 job 积分,因此 netCreditCost 表示当前实际净消耗。