图片生成（创建任务）
POST /v1/images/generations 参考，涵盖提示词、尺寸、参考图片、异步任务创建、点数和回调地址。
提交异步图片生成请求。接口返回任务 ID，你可以通过图片生成状态端点轮询结果。
端点
POST https://api.leaper.one/v1/images/generations参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 要生成图片的文本描述 |
| model | string | 是 | 模型 ID。支持："gpt-4o-image"、"gpt-image-2"、"gemini-3-pro-image-preview" |
| referenceImages | string | string[] | 否 | 用于风格或内容参考的图片 URL |
| number | number | 否 | 生成图片数量，范围 1-4。默认：1 |
| size | string | 否 | 图片尺寸，例如 "1024x1024"；或宽高比，例如 "9:16"。具体支持情况取决于模型 |
| callbackUrl | string | 否 | 生成完成后接收 POST 请求的 Webhook URL |
支持的模型
| 模型 | 说明 |
|---|---|
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。 |
请求
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 cat astronaut floating in space, digital art",
"number": 1,
"size": "1024x1024"
}'响应
{
"code": 0,
"msg": "success",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}注意事项
- 每张图片消耗 0.5 点数，创建任务时扣除。
- 余额不足时，API 返回 402 Payment Required。
- 使用返回的
id通过状态端点轮询结果。