异步生成图片
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
提交异步图片生成任务，立即返回 task_id（约 1 秒内）。通过
GET /v1/images/async/{taskId} 轮询状态，最长 10 分钟。
请求体 multipart/form-data。可选 image[] 字段直传参考图（同名
字段重复提交多张，最多 10 张）；不传即文生图。
计费按 quality 档位，提交时冻结、status=succeeded 时实际扣费；
失败 / 拒绝 / 错误自动退还冻结。
Authorization
BearerAuth AuthorizationBearer <token>
API 密钥认证（OpenAI 格式）。在 Authorization 请求头中传入：
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X post "https://api.xrtoken.net/v1/images/async" \ -F model="gpt-image-2" \ -F prompt="把背景换成樱花"{
"id": "4efa6a93-c0c8-4418-b11f-60152b3ce130",
"request_id": "tr-req-2ee8d1734e29472c9c7a15c7bd07bc76",
"status": "queued",
"model": "string",
"created_at": 0
}{
"error": "model field is required",
"type": "invalid_request_error"
}{
"error": "invalid or missing API key",
"type": "auth_error"
}{
"error": "insufficient balance -- please top up or upgrade your plan",
"type": "billing_error"
}{
"error": "rate limit exceeded",
"type": "rate_limit_error"
}