查询异步生图任务状态
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
按任务 id 查询异步图片任务。status 取值：
- queued：已入队待处理
- processing：worker 正在调用上游
- succeeded：完成，
result为图片响应；图片同时进入画廊。分层请求在result.data保留底图、透明 PNG 图层及位置和叠放元数据。 - failed：失败，
error为错误描述，冻结金额自动退还
建议轮询间隔 3–5 秒。分层计费包含底图及每个成功输出图层，按各自实际输出分辨率结算。
平台归档时可能将内嵌 b64_json 转为 url，但仍保留 z_index、name、description、bounding_box 等图层字段。
Seedream 5.0 Pro 计费方式
普通生成与图层拆分分别按实际输出分辨率结算。每张成功输出的实际像素数为其宽 × 高；261 万像素（2,610,000）及以下为低档，超过该值为高档。
底图也算一张输出；底图和所有成功图层各按自己的实际像素档位计费，同一请求可混合高低档。n=1 是一次拆分请求，不是只计一张费用。
只有成功输出计费，失败请求不扣费并退还冻结金额。
Pro 的首张参考图免费，第 2 张起按参考图张数收取输入费用。每次请求参考图费用为 max(参考图张数 − 1, 0) × 当前账户输入单价，仅计算一次，不按输出张数倍增；输出图片费用另算。分层恰好一张参考图，因此没有参考图输入费用。
适用的账户折扣同时作用于输入和输出单价。具体单价和适用折扣以当前调用站点的模型价格列表为准。
Authorization
BearerAuth AuthorizationBearer <token>
API 密钥认证（OpenAI 格式）。在 Authorization 请求头中传入：
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Path Parameters
taskId*string
任务 ID（由 POST /v1/images/async 返回的 id 字段）
Response Body
application/json
application/json
application/json
application/json
curl -X get "https://api.xrtoken.net/v1/images/async/string"{
"id": "string",
"status": "queued",
"model": "string",
"created_at": 0,
"error": "string",
"result": {
"created": 0,
"data": [
{
"url": "http://example.com",
"b64_json": "string",
"size": "1273x265",
"output_format": "string",
"z_index": 0,
"name": "string",
"description": "string",
"bounding_box": {
"absolute": [
383,
120,
1655,
384
],
"normalized": [
187,
59,
808,
188
]
}
}
],
"usage": {
"input_images": 0,
"generated_images": 0,
"input_tokens": 0,
"output_tokens": 0,
"total_tokens": 0
}
}
}{
"error": "invalid or missing API key",
"type": "auth_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "rate limit exceeded",
"type": "rate_limit_error"
}