图像生成与编辑

通过 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
json
{
  "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 别名。