gpt-image-1-mini

所需图像的文字描述，越详细越能获得符合预期的结果。
字符长度限制：

• GPT-Image系列模型：最多 32000 字符
• DALL-E-2：最多 1000 字符
• DALL-E-3：最多 4000 字符

撰写建议：

• 包含主体（如"baby sea otter"）、动作（如"playing"）、场景（如"in the ocean waves"）
• 指定风格（如"watercolor style"）、光线（如"soft light"）、色彩（如"blue and white"）
• 避免模糊表述，使用具体词汇提升生成精度

生成图像的尺寸，不同模型支持的选项不同：
-GPT-Image-2系列：支持任意尺寸，最长边不能超过3840px，总像素不能超过830万

• GPT-Image-1系列：1024x1024、1536x1024（横向）、1024x1536（纵向）、auto（自动适配）
• DALL-E-2：256x256、512x512、1024x1024
• DALL-E-3：1024x1024、1792x1024（横向）、1024x1792（纵向）

图像背景设置，仅适用于GPT-Image系列模型：

• transparent：透明背景（仅PNG/WEBP格式支持）
• opaque：不透明背景
• auto：自动判断（默认，根据提示词场景智能设置）

注意：选择transparent时，output_format需设置为png或webp

内容审核级别，控制生成图像的合规性：

• low：宽松审核，允许轻微创意表达
• auto：自动审核（默认），平衡合规与创意

生成的图像数量：

• 取值范围：1-10（GPT-Image/DALL-E-2）
• DALL-E-3仅支持n=1

注意：生成数量越多，消耗Token越多，生成时间越长

将生成的图像质量。auto（默认值）将自动为给定模型选择最佳质量。

• GPT-Image模型：支持high、medium、low三种模式。
• DALL-E-3：支持hd、standard画质。
• DALL-E 2：只能选standard。

图像压缩级别（仅GPT-Image支持，默认100）：

• 取值范围：0-100（百分比）
• 0：无压缩（文件最大，质量最佳）
• 100：最大压缩（文件最小，质量可能受损）

仅适用于webp/jpeg格式，png格式不支持压缩

图像输出格式（仅GPT-Image支持）：

• png：支持透明背景，无损压缩
• jpeg：兼容性好，文件较小
• webp：平衡压缩与质量，支持透明

选择transparent背景时，需使用png或webp格式

部分图像生成数量（仅GPT-Image支持）：

• 取值范围：0-3
• 0：不返回部分图像，生成完成后返回完整图像（默认）
• 1-3：分阶段返回部分图像预览，最终返回完整图像

仅在stream=true时生效，适合需要快速预览的场景

是否启用流式生成（仅GPT-Image支持）：

• false（默认）：生成完成后一次性返回
• true：以流式事件分阶段返回图像数据

结合partial_images参数可实现渐进式图像预览

要编辑的原始图像（必填）：

• GPT-Image系列（gpt-image-1/1-mini/1.5）：
  • 支持格式：PNG、WEBP、JPG
  • 单张大小：≤50MB
  • 数量限制：最多16张
• DALL-E 2：
  • 支持格式：仅PNG（方形）
  • 单张大小：≤4MB
  • 数量限制：仅1张

注意：多张图像上传时，遮罩仅作用于第一张图像

编辑效果的文字描述（必填）：

• 描述需替换的内容、风格、色彩等细节
• 字符长度限制：
  • GPT-Image系列：最多32000字符
  • DALL-E 2：最多1000字符
• 编写建议：结合原始图像场景，描述清晰具体

gpt-image-1、gpt-image-1-mini、gpt-image-1.5、gpt-image-2

遮罩图像（可选）：

• 作用：透明区域（alpha=0）指示原始图像中需要编辑的位置
• 要求：
  • 格式：仅PNG（支持透明通道）
  • 大小：≤4MB（所有模型）
  • 尺寸：必须与第一张原始图像完全一致
  • 数量：仅1张，多张原始图像时仅作用于第一张
• 适用场景：精准定位编辑区域，如替换图像中的特定物体

生成图像的质量等级：

• GPT-Image系列：支持auto/high/medium/low
• DALL-E 2：仅支持standard

生成图像的尺寸：

• GPT-Image系列：1024x1024、1536x1024、1024x1536、auto
• DALL-E 2：256x256、512x512、1024x1024

生成编辑后的图像数量：

• 取值范围：1-10
• 数量越多，Token消耗越多，生成时间越长

图像背景设置（仅适用于GPT-Image模型）：

• transparent：透明背景（仅PNG/WEBP格式支持）
• opaque：不透明背景
• auto：根据提示词和原始图像智能设置

输出图像格式（仅适用于GPT-Image模型）：

• 选择transparent背景时，需使用png或webp格式

图像压缩级别（仅适用于GPT-Image模型）：

• 取值范围：0-100（百分比）
• 0：无压缩（文件最大，质量最佳）
• 100：最大压缩（文件最小，质量可能受损）
• 仅适用于webp或jpeg格式，png格式不支持压缩

部分图像生成数量（仅适用于GPT-Image模型）：

• 取值范围：0-3
• 0：不返回部分图像，生成完成后返回完整图像（默认）
• 1-3：分阶段返回部分图像预览，最终返回完整图像
• 仅在stream=true时生效

是否启用流式生成（仅适用于GPT-Image模型）：

• false（默认）：生成完成后一次性返回
• true：以流式事件分阶段返回图像数据