查询图片生成任务

GET

/v1/image/task/query

按平台 taskId 查询图片生成任务状态和结果。

状态取值：queued / submitted / processing / completed / failed / cancelled。
任务完成后，images[*].url 为平台本地路径 /v1/image/tasks/{taskId}/cached-image，凭 API Key 或登录态直接访问即可。平台不会对外暴露具体的上游 CDN 地址。

请求参数

Authorization

API Key

在 header 添加参数

X-API-Key

示例：

X-API-Key: ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://superouter.nesports.top/v1/image/task/query?taskId=undefined' \
--header 'X-API-Key: <api-key>'

返回响应

🟢200

application/json

查询成功。

Bodyapplication/json

示例

已完成 — URL 指向平台本地缓存处理中失败

{
    "code": "200",
    "message": "Success",
    "result": {
        "taskId": "task_665bf35c1d664570980e8ecb378cc634",
        "status": "completed",
        "images": [
            {
                "url": "/v1/image/tasks/task_665bf35c1d664570980e8ecb378cc634/cached-image"
            }
        ]
    }
}

🟠404

🟠422

修改于 2026-04-24 06:44:39

提交图片生成任务

读取缓存图片