查询图片生成任务

GET

/v1/images/generations/{taskId}

taskId 填创建响应的 id。GET 不需要请求体，使用创建时的 Key。

status	含义	客户端处理
queued / in_progress	尚未完成	约 5 秒后继续查询
completed	成功	遍历 `data[].url` 下载图片
failed	失败或取消	停止轮询，检查 `error`

成功用量 usage 可选，按张计费不要求一定返回 Token。图片 URL 为平台结果，不是供应商私有任务地址；不存在单独的通用 taskId/result 查询步骤。URL 返回方式由本协议确定，不要依赖 response_format=b64_json 改变平台的最终响应格式。

查询示例

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

BASE_URL=https://api.starcore.cloud
API_KEY='<YOUR_API_KEY>'
TASK_ID='task_example_01'
curl --fail-with-body --request GET "$BASE_URL/v1/images/generations/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Accept: application/json"

返回响应

🟢200

application/json

任务状态；成功、处理中和失败均使用 HTTP 200，请检查 status。

Bodyapplication/json

示例

排队处理中成功（用量为可选示例）任务失败

{
    "id": "task_example_01",
    "status": "queued"
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴502

🔴503

修改于 2026-10-20 11:59:16

提交图片生成任务

提交图片编辑任务

查询图片生成任务

查询示例#

请求参数

请求示例代码

返回响应

查询示例