目录 · API 文档

GET /v1/images/{id}

查询某次生成任务的当前状态。Owner-only —— 只能查自己 key 对应账户下的任务。

路径参数

  • id:来自创建响应里的 aiimg_generation_id

响应(200)

{
  "id": "cmofjncu7007910z3...",
  "status": "succeeded",   // pending | succeeded | failed | canceled
  "created": 1714123456,
  "model": "gpt-image-2",
  "size": "1024x1024",
  "n": 1,
  "cost_tcoin": 2,
  "error": null,
  "data": [
    { "url": "https://chatgpt2.tokensolo.com/images/.../xxx.png" }
  ]
}

状态机

  • pending:仍在生成中
  • succeeded:成功,data 字段有图
  • failed:上游异常,T 币已退还,error 字段含原因
  • canceled:用户主动取消(API 当前不暴露 cancel;预留状态)

示例

curl https://aiimg.top/v1/images/cmofjncu7007910z3... \
  -H "Authorization: Bearer $AIIMG_API_KEY"