异步生成图片（task）
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
提交后立即返回 task_id（约 1 秒内）。通过 GET /v1/images/async/{taskId} 轮询任务状态。
请求体：multipart/form-data
| 字段 | 必填 | 说明 |
|---|---|---|
model | ✓ | 模型 ID，如 gpt-image-2 |
prompt | ✓ | 提示词（最长 32K 字符） |
size | 图片尺寸，例如 1024x1024 | |
quality | low / medium（默认）/ high | |
n | 生成数量，1-10，默认 1 | |
image[] | 参考图二进制（PNG/JPEG/WebP，单张 ≤4MB），最多 10 张。用同名字段重复传入 |
响应：
{
"id": "<task_id>",
"request_id": "tr-req-...",
"status": "queued",
"model": "gpt-image-2",
"created_at": 1777445820
}计费：按 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"
}