Skip to content

GET /v1/gpt/images/:task_id

接口用途

查询异步图片任务状态。

这条接口依赖扩展任务能力;当相关能力未启用时,会直接返回不支持。

请求路径

text
GET /v1/gpt/images/:task_id

认证方式

  • Authorization: Bearer <API_KEY>
  • x-api-key: <API_KEY>

路由别名

  • GET /gpt/images/:task_id

适用平台

  • OpenAI 图片异步任务扩展场景

本项目支持说明

路由内部会先尝试调用扩展任务查询逻辑:

  • 如果扩展已启用:返回任务结果
  • 如果扩展未启用:返回 404 Task API is not enabled

路径参数

参数类型必填说明
task_idstring任务 ID

响应说明

响应内容取决于异步任务扩展实现。

错误响应

json
{
  "error": {
    "type": "not_found_error",
    "message": "Task API is not enabled"
  }
}

示例请求

bash
curl https://your-domain/api/v1/v1/gpt/images/task_123 \
  -H "Authorization: Bearer sk-xxxx"