XRToken API 文档

查询异步生图任务状态

API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net

task_id 查询异步生图任务。status 取值:

  • queued:已入队待处理
  • processing:worker 正在调上游
  • succeeded:完成,result 字段为 OpenAI 形态 {data:[{url}]} 响应;图片同时进入画廊
  • failed:失败,error 字段为错误描述,已冻结金额自动退还

建议轮询间隔 3-5 秒。

GET
/v1/images/async/{taskId}

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"
      }
    ],
    "usage": {
      "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"
}