图片

图片接口

这页从 image 的角度看接口。

图片是最轻的一类创作：创建链路和其他类型一样，但参数更少，结果也更直接。

创建

POST /creations

最小公共字段：

• type=image
• prompt
• language
• 从 /catalog 读取的比例与质量字段

Nano Banana 2

当 catalog 选到 Nano Banana 2 时，当前前端会走 Gemini 路线：

• image_generation.provider=gemini
• image_generation.model=nano-banana-2
• extra_config.output.aspect_ratio 支持 16:9 / 9:16 / 1:1
• extra_config.output.quality 继续走 1K / 2K / 4K

GPT-Image-2

当 catalog 选到 GPT-Image-2 时，当前前端会走 Azure OpenAI 路线：

• image_generation.provider=azure_openai
• image_generation.model=gpt-image-2
• extra_config.output.aspect_ratio 支持 3:2 / 2:3 / 1:1
• image_generation.quality 支持 low / medium / high
• 前端展示名当前收口为 Basic / Standard / Premium
• 当前前端积分口径：low=3、medium=5、high=12
• 当前前端会在 GPT-Image-2 模型后显示蓝色 New 标识
• 当前前端会在 GPT 质量档选项后显示 40% OFF 折扣标识

管理

图片类管理通常只关心：

• 是否生成成功
• 主图 URL
• 缩略图
• 可能存在的附件图

编辑

图片类通常不优先暴露复杂单场景编辑。

更常见的方式是：

• 改 prompt 重新生成
• 改模型重新生成
• 改比例或质量重新生成

实践建议

• 图片也继续走统一的 POST /creations 公共创建链路，不要再接到旧的独立 endpoint
• 不要复用视频的 duration / voice 参数
• 图片当前已区分模型：不要再假设所有 image 都共用同一套比例和质量档位
• style 已不再作为 image 创建页显式参数
• 结果返回时优先给可直接展示的主图链接