超然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}/result
任务未完成时 result 为 null。任务完成后按功能返回不同格式:
通用字段:
data.task_id:任务 ID,与创建任务返回的 task_id 一致。
data.status:任务状态。CREATED 为已创建或排队中,RUNNING 为处理中,DONE 为已完成,FAILED 为处理失败。
data.result:任务结果。未完成时为 null;完成后按任务类型返回。
data.result.result_type:结果类型。ASSET 表示图片资产结果,ASSET_PENDING 表示结果资产仍在落库或暂不可用,JSON 表示结构化结果。
图片资产结果字段:
result.output_urls[]:已保存到超然POD平台资产中的公开结果图片 URL,不带过期签名参数。
result.assets[]:结果资产数组。
result.assets[].asset_id:超然POD平台资产 ID。
result.assets[].url:超然POD平台资产公开 URL。
result.assets[].mime:文件 MIME 类型。
result.assets[].size_bytes:文件大小,单位 Byte。
各接口结果说明:
图案提取 V1:result_type=ASSET;output_urls/assets 返回提取后的图案图片。
图案提取 V2:result_type=ASSET;output_urls/assets 返回提取后的图案图片。
图案裁剪:result_type=ASSET;output_urls/assets 返回裁剪后的图案图片。
图生图:result_type=ASSET;output_urls/assets 返回生成的图片,可能有多张。
文生图:result_type=ASSET;output_urls/assets 返回根据提示词生成的图片,可能有多张。
AI 写标题:result_type=JSON;result.data.title 返回已拼接标题模板前缀、模型标题、标题模板后缀后的最终标题。
图片高清:result_type=ASSET;output_urls/assets 返回高清处理后的图片。
印花抠图:result_type=ASSET;output_urls/assets 返回抠图后的图片。
违规检测:result_type=JSON;result.data.riskLevel 为风险等级,result.data.riskAnalysis 为风险说明。
TRO 检测:result_type=JSON;result.data.risk_level 为风险等级,result.data.risk_report 为风险报告,result.data.clues[] 为相关线索,最多 20 条。

请求参数

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//result' \
--header 'x-api-key: {{api_key}}'

返回响应

🟢200成功
application/json
任务结果
Bodyapplication/json

示例
{
    "code": "0",
    "message": "ok",
    "data": {
        "task_id": "string",
        "status": "CREATED",
        "result": {
            "result_type": "ASSET",
            "output_urls": [
                "http://example.com"
            ],
            "assets": [
                {
                    "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",
                    "url": "http://example.com",
                    "mime": "image/png",
                    "size_bytes": 0
                }
            ],
            "data": {
                "title": "Vintage Blue Wolf Floral Graphic T-Shirt"
            }
        }
    }
}
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
修改于 2026-06-08 09:06:35
上一页
查询任务状态
下一页
查询标题模板列表
Built with