/v1/images/edits原“Flux 编辑（OpenAI dall-e-3 格式）”链接保留为迁移说明；FLUX 与 GPT Image 是不同模型系列，不能共用全部参数限制。
本目录的生成、编辑和蒙版教程适用于模型表中的 GPT Image 型号，不适用于 FLUX。请求路径相似或返回结构兼容，并不表示底层模型是 DALL·E 3 或 GPT Image。
原页面的格式名称不能作为 FLUX 支持模型、输入数量、蒙版、尺寸和返回方式的依据。不要把 GPT Image 的 quality=xhigh、max、16 张输入上限或透明背景规则直接发给 FLUX。
需要 GPT Image 编辑时，按本地图片上传或 JSON 编辑使用完整 GPT Image 模型 ID。需要继续使用 FLUX 时，请在“绘画模型 → FLUX 系列”查找具体模型文档，并核对你的账号可用模型；找不到对应型号或调用入口时，联系本站支持确认。
本页保留原收藏链接，不附未经确认的 FLUX 调用示例。GPT Image 的完整字段与组合见参数说明。
使用青云TOP API 的 Images 兼容入口生成或编辑图片。它复用 OpenAI Images 的请求形状，但页面中的厂商型号、别名和能力仍需按本站当前模型目录核对。
/v1/images/editsBodyobjectimagestring必填要编辑的图片。必须是受支持的图片文件或图片数组。对于 gpt-image-1，每张图片应为小于 25MB 的 png、webp 或 jpg 文件。对于 dall-e-2，您只能提供一张图片，并且该图片应为小于 4MB 的方形 png 文件。
file://C:\Users\Administrator\Desktop\87069cf1-8838-4acf-bb31-e02e6c9a11eb.pngpromptstring必填所需图像的文本描述。dall-e-2 的最大长度为 1000 个字符，gpt-image-1 的最大长度为 32000 个字符。
换成红色衣服maskstring必填一张附加图片，其完全透明区域（例如，alpha 值为零）指示应编辑 image 位置。如果提供了多张图片，则遮罩将应用于第一张图片。必须是有效的 PNG 文件，小于 4MB，且尺寸与 image 相同。
modelstring必填用于生成图像的模型。仅支持 dall-e-2 和 gpt-image-1。除非使用特定于 gpt-image-1 参数，否则默认为 dall-e-2。
flux-kontext-maxninteger必填要生成的图像数量。必须介于 1 到 10 之间。
1qualitystring必填生成图像的质量。只有 gpt-image-1 支持 high、medium 和 low 质量。dall-e-2 仅支持 standard 质量。默认为 auto。
response_formatstring必填返回生成图像的格式。必须是 url 或 b64_json 之一。URL 在图像生成后 60 分钟内有效。此参数仅适用于 dall-e-2，因为 gpt-image-1 始终返回 base64 编码的图像。
b64_jsonsizestring必填生成图像的尺寸。对于 gpt-image-1，必须为 1024x1024、1536x1024（横向）、1024x1536（纵向）或 auto（默认值）之一；对于 dall-e-2，必须为 256x256、512x512 或 1024x1024 之一。
aspect_ratiostring生成图像的尺寸。枚举值Possible enum values: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21
16:9backgroundstring允许为生成的图像的背景设置透明度。此参数仅在 gpt-image-1 中受支持。其值必须为 “透明（transparent）”、“不透明（opaque）” 或 “自动（auto）”（默认值）之一。当使用 “自动（auto）” 时，模型将自动为图像确定最佳背景。
transparentmoderationstring控制由 gpt-image-1 生成的图像的内容审核级别。可以设置为 “low” 以进行限制较少的过滤，也可以设置为 “auto”（默认值）。
low| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
200响应 200objectidstring必填objectstring必填createdinteger必填choicesarray<object>必填元素objectindexintegermessageobjectrolestring必填contentstring必填finish_reasonstringusageobject必填prompt_tokensinteger必填completion_tokensinteger必填total_tokensinteger必填使用青云TOP API 的 Images 兼容入口生成或编辑图片。它复用 OpenAI Images 的请求形状，但页面中的厂商型号、别名和能力仍需按本站当前模型目录核对。