Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

GPT-Image 家族

这个模型家族使用统一图像入口路由,对外兼容 OpenAI Images 风格;实际模型由 model 字段决定。

支持模型

模型名说明生成编辑默认质量默认尺寸
gpt-image-1当前统一图像入口里显式处理的主模型支持支持auto由上游决定
dall-e-3DALL·E 3 兼容模型支持依渠道决定standard1024x1024
dall-e-2DALL·E 2 兼容模型支持依渠道决定无强制默认值1024x1024
dall-eDALL·E 旧别名支持依渠道决定无强制默认值1024x1024

支持能力

能力入口说明
文生图/v1/images/generations标准生成入口
图像编辑/v1/images/edits编辑入口
图像编辑别名/v1/edits旧版别名
图像变体/v1/images/variations路由保留,当前未实现

支持模式

模式判断条件入口
文生图只传 prompt,不传编辑素材/v1/images/generations
图像编辑image 或多图参考,再配合 prompt/v1/images/edits/v1/edits
局部重绘在编辑请求中额外传 mask/v1/images/edits/v1/edits

输出限制

字段约束
response_format常见值为 urlb64_json
n不传或显式传 0 时,统一层回退为 1
sizedall-e-2 仅允许 256x256512x5121024x1024
sizedall-e-3 仅允许 1024x10241024x17921792x1024

统一入口说明

  • 统一层会先按 OpenAI Images 风格解析请求,再分发到具体图像渠道。
  • model 是强制字段;统一层会先校验它是否存在。
  • watermark 使用指针字段承载,显式传 false 与不传语义不同。
  • 请求 b64_jsonbase64 时,返回中会改用 Base64 图像数据。

子接口页面

图像生成

POST /v1/images/generations

图像编辑

POST /v1/images/editsPOST /v1/edits

推荐阅读顺序

  1. 图像生成
  2. 图像编辑
  3. 上传图片

相关页面