超然POD
  1. 查询任务
  • 接入说明
  • 创建任务
    • 图案提取 V1
      POST
    • 图案提取 V2
      POST
    • 图案裁剪
      POST
    • 图生图
      POST
    • 文生图
      POST
    • AI 写标题
      POST
    • 图片高清
      POST
    • 印花抠图
      POST
    • 违规检测
      POST
    • TRO 检测
      POST
  • 查询任务
    • 错误码说明
    • 查询任务状态
      GET
    • 查询任务结果
      GET
  • 标题模板
    • 查询标题模板列表
      GET
  • 上传图片
    • 上传图片
      POST
  1. 查询任务

查询任务状态

GET
/openapi/v1/tasks/{task_id}
根据 task_id 查询任务当前状态。只允许查询当前 API Key 创建的任务。
响应体字段:
data.task_id:任务 ID,与创建任务返回的 task_id 一致。
data.status:任务状态。CREATED 为已创建或排队中,RUNNING 为处理中,DONE 为已完成,FAILED 为处理失败。
data.capability_code:公开功能代码,例如 v1tiqu、matting、tdetect。
data.request_id:请求 ID,用于排查问题。
data.created_at:任务创建时间。
data.updated_at:任务最近更新时间。
data.finished_at:任务完成时间。未完成时为空。
data.error_code:失败错误码。非 FAILED 状态为空。
data.error_message:失败原因。非 FAILED 状态为空。

请求参数

Path 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/openapi/v1/tasks/' \
--header 'x-api-key: {{api_key}}'

返回响应

🟢200成功
application/json
任务状态
Bodyapplication/json

示例
{
    "code": "0",
    "message": "ok",
    "data": {
        "task_id": "30df558c-6f94-4c4e-b976-d60569fe595d",
        "status": "CREATED",
        "capability_code": "idetect",
        "request_id": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "finished_at": 0,
        "error_code": "string",
        "error_message": "string"
    }
}
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
修改于 2026-06-08 09:06:35
上一页
错误码说明
下一页
查询任务结果
Built with