4SToken
API Reference

接口参考

按接口拆分查看请求地址、输入参数、输出参数与错误代码。

编程工具接入模型与价格
Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude Messages
GET /v1/images/tasks/{taskId}

图片任务查询

查询图片异步任务状态与结果；终态结果默认返回已落库的图片 URL。传 callbackUrl 时，网关成功回调的 JSON body 与本接口成功响应保持一致。

上一页 下一页

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/images/tasks/{taskId}
请求方式GET
Content-Type无请求体
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
taskIdstring是路径参数，图片任务 ID。

输出参数

参数类型返回说明
task_idstring是任务 ID。
statusstring是pending / running / succeeded / failed / canceled。
createdinteger成功时任务完成时间。
data[].urlstring成功时生成图片 URL；异步任务终态默认返回该字段。
usageobject否图片生成 token 用量统计。
errorobject失败时失败原因。

补充说明

  • callbackUrl 回调：网关向调用方提供的 URL 发起 POST，Content-Type 为 application/json。
  • 回调 body 与本接口成功状态响应一致，顶层直接包含 task_id、taskId、status、data、usage、error 等字段，不再包裹 result。
  • 兼容说明：灰度期间如收到旧版 { result: { data: [...] } } 包装，Portal 预览仍会兼容解析其中的图片 URL。

错误代码

HTTP 状态码错误说明
401UnauthorizedClient Key 无效或未提供。
404Not Found任务不存在或不可访问。

示例

响应示例

{
  "created": 1710000000,
  "task_id": "gw-img-202406010001",
  "status": "succeeded",
  "data": [
    {
      "url": "https://example.com/generated/image.png"
    }
  ],
  "usage": {
    "input_tokens": 7148,
    "output_tokens": 7024,
    "total_tokens": 14172,
    "input_tokens_details": {},
    "output_tokens_details": {}
  }
}