生成图像
用途
基于文本提示生成 AI 图像。可选择上传参考图像，以参考生成结果的样式或构图。
方法和路径
POST /public/v1/generate/image
认证
请参阅 认证 页面。需要 Bearer 令牌。
必需头信息：
Authorization: Bearer {your_api_key}
请求字段
| 字段名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 图像生成的文本提示 |
| ai_model | string | 是 | 使用的 AI 模型。可能的值: GPT Image 1.5, GPT Image 2, Grok Imagine, Grok Imagine Pro, Nano Banana, Nano Banana 2, Nano Banana Pro |
| ref_images | file[] | 否 | 参考图像文件 (multipart/form-data)。根据 AI 模型不同，最大上传数量不同 |
响应
成功响应 (200 OK)：
{
"job_id": "uuid-string"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| job_id | string | 创建的作业的唯一标识符。使用 Get Job Status 查询结果 |
错误 / 验证规则
| 情况 | HTTP 状态 | 错误消息 |
|---|---|---|
| Invalid image file | 400 | "Invalid image file" |
| Grok Imagine 模型中 ref_images 超过 5 个 | 400 | "The Grok Imagine model supports up to 5 ref_images." |
| Grok Imagine Pro 模型中 ref_images 超过 1 个 | 400 | "The Grok Imagine Pro model supports up to 1 ref_images." |
| 其他模型中 ref_images 超过 10 个 | 400 | "ref_images supports up to 10 images only" |
| 认证失败 | 401 | 无效的 API 密钥 |
参考图像限制：
- GPT Image 1.5: 最多 10 个
- Grok Imagine: 最多 5 个
- Grok Imagine Pro: 最多 1 个
- Nano Banana 系列: 最多 10 个
异步作业行为
此端点创建异步作业。请求立即返回 job_id，实际图像生成在后台进行。
轮询方法：
- 保存响应中收到的
job_id - 轮询
GET /public/v1/job/{job_id}检查状态 - 当状态变为
Succeed时，从image_urls查看结果
状态流程： Pending → Succeed 或 Failed
请求示例
cURL (无参考图像)：
curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a beautiful sunset over mountains" \
-F "ai_model=GPT Image 1.5"
cURL (包含参考图像)：
curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a cat in the style of the reference" \
-F "ai_model=Grok Imagine" \
-F "ref_images=@/path/to/ref1.jpg" \
-F "ref_images=@/path/to/ref2.jpg"