GPT Image 2
创建或编辑 GPT Image 2 图片
/v1/images/generations通过 Images API 调用 gpt-image-2，支持文本生图、参考图编辑、蒙版重绘和流式图片生成。
认证
通过 Bearer Token 认证。文本生图使用 JSON，请求图片编辑时使用 multipart/form-data。
API Key，格式为 Bearer YOUR_API_KEY。
默认值：-文本生图使用 JSON；图片编辑使用 multipart/form-data。
默认值：application/json 或 multipart/form-data客户侧生成的唯一请求标识，用于追踪和排查。
默认值：-文本生成图片
POST /v1/images/generations
固定传 gpt-image-2。
默认值：gpt-image-2图片生成提示词，建议明确主体、场景、构图、风格和比例。
默认值：-生成图片数量。
默认值：1输出尺寸，支持 auto 和符合约束的常用尺寸。
默认值：auto图片质量：low、medium、high 或 auto。
默认值：auto背景模式：auto 或 opaque。gpt-image-2 当前不支持透明背景。
默认值：auto输出格式：png、jpeg 或 webp。
默认值：pngJPEG/WebP 压缩等级，取值 0 到 100。
默认值：100图片安全过滤强度：auto 或 low。
默认值：auto是否启用流式图片生成。
默认值：false流式模式下返回的中间图数量，需要与 stream: true 一起使用。
默认值：-图片编辑
POST /v1/images/edits
固定传 gpt-image-2。
默认值：gpt-image-2输入图片，支持 PNG、WebP、JPG。可传多张参考图。
默认值：-编辑或生成指令。
默认值：-蒙版图片。需与第一张 image 格式和尺寸一致，并包含 alpha 通道。
默认值：-输出尺寸。
默认值：auto图片质量。
默认值：auto输出格式：png、jpeg 或 webp。
默认值：png响应
响应返回图片数据和本次生成的实际配置。
创建时间，Unix 时间戳。
默认值：-实际使用的背景模式。
默认值：-实际输出格式。
默认值：-实际图片质量。
默认值：-实际输出尺寸。
默认值：-图片结果列表。
默认值：-Base64 编码后的图片数据。
默认值：-图片生成 Token 用量统计。
默认值：-尺寸约束
自定义尺寸通常需要满足：最长边不超过 3840px、宽高为 16px 的倍数、长短边比例不超过 3:1，并处于模型允许的总像素范围内。
错误
| 状态码 | 说明 |
|---|---|
400 | 请求体字段错误、图片文件格式错误、尺寸不支持或蒙版不合法 |
401 | API Key 缺失或无效 |
403 | 当前账户无权调用该模型 |
429 | 请求超过速率限制 |
500 / 503 | 平台或上游模型服务异常 |