查询生图任务

查询生图任务

curl --request GET \
  --url https://api.ch88.cn/v1/open/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ch88.cn/v1/open/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 200,
  "data": {
    "task_id": "task_01K4Y8R6Z1J2X3M4N5P6Q7R8S9",
    "status": "succeeded",
    "created_at": "2026-09-12T08:30:00.000Z",
    "completed_at": "2026-09-12T08:31:42.000Z",
    "result": {
      "images": [
        {
          "asset_id": "generated/open-result/task_01K4Y8R6Z1J2X3M4N5P6Q7R8S9-0.png",
          "url": "https://api.ch88.cn/v1/open/assets/generated%2Fopen-result%2Ftask_01K4Y8R6Z1J2X3M4N5P6Q7R8S9-0.png",
          "expires_at": "2026-09-15T08:31:42.000Z"
        }
      ]
    },
    "error": null
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 403,
    "type": "permission_error",
    "message": "成员或组织已停用"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 404,
    "type": "not_found_error",
    "message": "任务不存在或不属于当前成员",
    "details": {
      "upstream_code": "TASK_NOT_FOUND"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 429,
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 502,
    "type": "upstream_error",
    "message": "上游服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

GET

https://api.ch88.cn

open

tasks

{task_id}

查询生图任务

curl --request GET \
  --url https://api.ch88.cn/v1/open/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ch88.cn/v1/open/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 200,
  "data": {
    "task_id": "task_01K4Y8R6Z1J2X3M4N5P6Q7R8S9",
    "status": "succeeded",
    "created_at": "2026-09-12T08:30:00.000Z",
    "completed_at": "2026-09-12T08:31:42.000Z",
    "result": {
      "images": [
        {
          "asset_id": "generated/open-result/task_01K4Y8R6Z1J2X3M4N5P6Q7R8S9-0.png",
          "url": "https://api.ch88.cn/v1/open/assets/generated%2Fopen-result%2Ftask_01K4Y8R6Z1J2X3M4N5P6Q7R8S9-0.png",
          "expires_at": "2026-09-15T08:31:42.000Z"
        }
      ]
    },
    "error": null
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 403,
    "type": "permission_error",
    "message": "成员或组织已停用"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 404,
    "type": "not_found_error",
    "message": "任务不存在或不属于当前成员",
    "details": {
      "upstream_code": "TASK_NOT_FOUND"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 429,
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 502,
    "type": "upstream_error",
    "message": "上游服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": 200,
  "data": {
    "task_id": "task_01K4Y8R6Z1J2X3M4N5P6Q7R8S9",
    "status": "succeeded",
    "created_at": "2026-09-12T08:30:00.000Z",
    "completed_at": "2026-09-12T08:31:42.000Z",
    "result": {
      "images": [
        {
          "asset_id": "generated/open-result/task_01K4Y8R6Z1J2X3M4N5P6Q7R8S9-0.png",
          "url": "https://api.ch88.cn/v1/open/assets/generated%2Fopen-result%2Ftask_01K4Y8R6Z1J2X3M4N5P6Q7R8S9-0.png",
          "expires_at": "2026-09-15T08:31:42.000Z"
        }
      ]
    },
    "error": null
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 403,
    "type": "permission_error",
    "message": "成员或组织已停用"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 404,
    "type": "not_found_error",
    "message": "任务不存在或不属于当前成员",
    "details": {
      "upstream_code": "TASK_NOT_FOUND"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 429,
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 502,
    "type": "upstream_error",
    "message": "上游服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

授权

Authorization

string

header

必填

成员级 Public API Key。请填写完整密钥，Mintlify Playground 会自动以 Authorization: Bearer <PUBLIC_API_KEY> 发送。完整明文只在管理后台创建成功时显示一次。

路径参数

task_id

string

必填

生图提交响应 data.task_id 中的任务编号。

响应

当前任务状态。任务成功时 result.images 包含生成素材。

code

integer

必填

HTTP 状态码。

data

object

必填

Hide child attributes

data.task_id

string

必填

异步任务编号。

data.status

enum<string>

必填

任务状态。queued 排队中；processing 处理中；其余三个值为终态。

可用选项:

queued,

processing,

succeeded,

failed,

cancelled

data.created_at

string<date-time>

必填

任务创建时间，ISO 8601 UTC 格式。

data.completed_at

string<date-time> | null

必填

任务完成时间。未进入终态时为 null。

data.result

object | null

必填

任务成功后的生成结果；尚未完成或失败时通常为 null。

Hide child attributes

data.result.images

object[]

必填

生成图片列表。

Hide child attributes

data.result.images.asset_id

string

必填

生成素材标识。自行拼接下载 URL 时需要进行 URL 编码。

data.result.images.url

string<uri>

必填

生成图片的临时完整访问地址，可在有效期内直接通过浏览器访问。

data.result.images.expires_at

string<date-time> | null

必填

图片预计过期时间。缓存成功时最长为 3 天；为 null 时应尽快下载。

data.error

必填

任务失败信息。成功或未完成时通常为 null。

Hide child attributes

data.error.code

string

任务失败错误码。

data.error.message

string

可向开发者展示的错误说明。

request_id

string

必填

本次请求的诊断编号。联系平台排查问题时请提供，不要记录 Public API Key。

示例:

"req_550e8400-e29b-41d4-a716-446655440000"

接口概览

全部接口

授权

路径参数

响应