图像生成与编辑
通过 OpenAI 兼容的图像接口生成和编辑图像,支持多部分上传与 JSON 图像 URL 输入。
概览
使用标准 OpenAI 图像路由生成全新图像或编辑既有图像,原生支持文件上传及针对 gpt-image-2 的非流式 JSON 图像 URL 输入。
图像生成
POST
/v1/images/generations- 规范端点:
POST /v1/images/generations(operationId: openai.images.generations)接收提示词并生成全新图像。 - 生成参数:接收
prompt以及可选的model、n、quality和size。 - 兼容别名:兼容接收
POST /openai/v1/images/generations(operationId: openai.images.generations.alias)。
图像编辑
POST
/openai/v1/images/edits{
"model": "gpt-image-2",
"prompt": "将这些参考图像融合为一幅超现实主义风格的艺术肖像。",
"images": [
{ "image_url": "https://cdn.example.com/reference-1.png" },
{ "image_url": "https://cdn.example.com/reference-2.png" }
],
"mask": {
"image_url": "https://cdn.example.com/mask.png"
},
"n": 1,
"quality": "medium",
"size": "1024x1024"
}- 规范端点:
POST /openai/v1/images/edits(operationId: openai.images.edits),同时提供兼容别名POST /v1/images/edits(operationId: openai.images.edits.alias)。 - JSON URL 输入:针对
gpt-image-2及支持的原生通道,发送非流式 JSON,包含model、prompt、含 1 至 16 个image_url对象的images数组以及可选mask对象(image_url)。 - 公开 HTTPS 规范:图像 URL 必须为可直接公开访问的 HTTPS 地址且不含内嵌鉴权凭据,由上游直接读取。
- 质量与尺寸控制:
gpt-image-2默认quality为medium(同时支持low与high);其他原生参数透传至底层。 - 操作契约:基于
operationId: openai.images.edits发布,并兼容支持POST /v1/images/edits别名。