图片生成
图片生成接口用于从文本 prompt 创建图片，适合产品图、海报、素材草图、封面和营销视觉生成。常用模型包括 gpt-image-2、gpt-image-2-pro、doubao-seedream-5-0-260128、grok-imagine-image 等。
接口路径
| 方法 | 路径 | 返回方式 |
|---|---|---|
POST | /v1/images/generations | 同步返回图片结果或图片响应。 |
POST | /v1/images/generations/async | 先返回任务 ID，随后查询图片结果。 |
请求示例
bash
curl https://moonapix.com/v1/images/generations \
-H "Authorization: Bearer <MOONAPIX_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A clean product mockup on a white studio table.",
"size": "1024x1024",
"n": 1
}'常用字段
| 字段 | 说明 |
|---|---|
model | 图片模型名，例如 gpt-image-2、doubao-seedream-5-0-260128、grok-imagine-image。 |
prompt | 图片描述。 |
size | 输出尺寸，例如 1024x1024。 |
n | 生成数量。 |
response_format | 返回格式，以 API Reference 为准。 |
结果处理
| 场景 | 处理方式 |
|---|---|
| 返回图片 URL | 保存 URL、prompt、模型名和尺寸。 |
| 返回图片内容 | 先落到业务文件存储，再保存可访问地址。 |
| 批量生成 | 按返回顺序绑定每张图和生成参数。 |
| 异步生成 | 保存 id，轮询 GET /v1/images/tasks/{task_id}，成功后读取 data[].url。 |
接入建议
- Prompt 建议包含主体、场景、风格、比例和用途。
- 批量生成时保存 prompt、模型名、尺寸和结果 URL。
- 同步接口会等待图片生成完成；长耗时任务或不希望保持长连接时，使用 图片异步任务。
- 需要基于已有图片修改时使用 图片编辑。