图片生成（创建任务）
POST /v1/images/generations 参考，涵盖提示词、尺寸、参考图片、异步任务创建、点数和回调地址。
提交异步图片生成请求。接口返回任务 ID，你可以通过图片生成状态端点轮询结果。
端点
POST https://api.leaper.one/v1/images/generations参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 要生成图片的文本描述 |
| model | string | 是 | 使用下方支持模型表中的模型 ID |
| referenceImages | string | string[] | 否 | 用于风格或内容参考的图片 URL |
| number | number | 否 | 生成图片数量，范围 1-4。默认：1 |
| size | string | 否 | 图片尺寸，例如 "1024x1024"；或宽高比，例如 "9:16"。具体支持情况取决于模型 |
| callbackUrl | string | 否 | 生成完成后接收 POST 请求的 Webhook URL |
支持的模型
| 模型 ID | 名称 | 售价 |
|---|---|---|
gpt-4o-image | GPT-4o Image | 0.5 credits/张 |
gpt-image-2 | GPT Image 2 | 0.01 credits/张 |
gemini-3.1-flash-image-preview | Gemini 3.1 Flash Image Preview | 约 0.081714 credits/张 |
请求
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"
}
}注意事项
- 创建任务时预占
模型单价 × number的额度，成功后按实际生成张数结算。 - 任务失败会释放全部预占额度；部分成功只收取成功图片的费用。
- 余额不足时，API 返回 402 Payment Required。
- 使用返回的
id通过状态端点轮询结果。