图像生成指南
了解如何通过 LEAPERone 创建图像、提交提示词和参考图像、轮询异步任务并接收回调。
图像生成采用异步两步流程：先创建任务，再轮询结果。
支持的模型
gpt-4o-image— OpenAI GPT-4o 图像生成模型。gpt-image-2— OpenAI GPT Image 2。除固定尺寸外，还支持"9:16"等宽高比size值。gemini-3-pro-image-preview— Google Gemini 3 Pro Image。
第 1 步：创建任务
curl -X POST https://api.leaper.one/v1/images/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-image",
"prompt": "A watercolor painting of a mountain lake at sunrise"
}'{
"code": 0,
"msg": "success",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}第 2 步：轮询状态
使用返回的 id 查询任务进度：
curl https://api.leaper.one/v1/images/generations/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer sk-your-api-key"{
"code": 0,
"msg": "success",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed",
"images": [
{
"id": "image-abc123",
"url": "https://s3.bitiful.net/leaperone/images/generated/abc123?X-Amz-Expires=3600&..."
}
]
}
}状态值
| 状态 | 含义 |
|---|---|
pending | 任务已进入队列，尚未开始。 |
processing | 模型正在生成图像。 |
uploading | 图像正在上传到存储服务。 |
partial | 部分图像已经就绪，适用于多图请求。 |
completed | 所有图像都已就绪。 |
failed | 生成失败。 |
Webhook 回调
除了轮询，你也可以传入 callbackUrl，在任务结束时接收 POST 通知：
{
"model": "gpt-4o-image",
"prompt": "A neon-lit cyberpunk cityscape",
"callbackUrl": "https://your-server.com/webhook/image"
}每张生成图像消耗 0.5 credits。
轮询任务时返回的图像 URL 带有签名，会在 1 小时后过期。请使用 data.images[].url 中的最新值；需要新 URL 时，请再次轮询任务。
完整参数列表和响应结构请参阅 API 参考。