图片生成
POST /v1/images/generations
提交图片生成任务。兼容 OpenAI Images API 格式。
所有请求统一异步返回 task_id，不阻塞等待生成完成。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | ✅ | 模型名称，如 gpt-image-2 |
prompt | string | ✅ | 生成提示词（最长 4000 字符） |
size | string | — | 尺寸：1024x1024、1024x1536、1536x1024、auto（默认） |
n | integer | — | 生成数量 1-4（默认 1） |
quality | string | — | 质量：low、medium、high、auto（默认） |
callback_url | string | — | 任务完成后回调地址（详见 Webhook） |
请求示例
curl https://api.token8.pro/v1/images/generations \
-H "Authorization: Bearer sk-你的AutoKey" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A sunset over mountains, cinematic lighting",
"size": "1024x1024",
"quality": "high",
"callback_url": "https://your-server.com/webhook"
}'
callback_url可选。传入后任务完成时自动 POST 结果到该地址，无需轮询。详见 Webhook 回调。
响应 200
{
"task_id": "task_abc123def456",
"status": "pending",
"model": "gpt-image-2",
"created_at": 1714450000
}
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 任务已提交 |
| 400 | 请求参数错误 |
| 401 | API Key 无效或已过期 |
| 402 | 余额不足 |
| 429 | 请求频率超限 |
| 500 | 服务内部错误 |
获取结果
任务提交后需等待生成完成。
Webhook 回调（推荐）：请求时传 callback_url，任务完成后 Token8 自动 POST 结果到你的服务器。详见 Webhook 回调。
轮询（备选）：用 task_id 调用 任务查询接口 主动获取状态，建议间隔 10-15 秒。