image-api

# 图像 API 快速参考 ## 端点 - 生成：`POST /v1/images/generations` (`client.images.generate(...)`) - 编辑：`POST /v1/images/edits` (`client.images.edit(...)`) ## 模型 - 默认：`gpt-image-1.5` - 替代方案：`gpt-image-1-mini`（用于更快、成本更低的生成） ## 核心参数（生成 + 编辑） - `prompt`: 文本提示词 - `model`: 图像模型 - `n`: 图像数量 (1-10) - `size`: `1024x1024`, `1536x1024`, `1024x1536`, 或 `auto` - `quality`: `low`, `medium`, `high`, 或 `auto` - `background`: `transparent`, `opaque`, 或 `auto`（透明需要 `png`/`webp`） - `output_format`: `png` (默认), `jpeg`, `webp` - `output_compression`: 0-100 (仅限 jpeg/webp) - `moderation`: `auto` (默认) 或 `low` ## 编辑特定参数 - `image`: 一个或多个输入图像（第一张图像为主） - `mask`: 可选遮罩图像（相同尺寸，需要 Alpha 通道） - `input_fidelity`: `low` (默认) 或 `high`（支持情况因模型而异）- 如果用户需要非常具体的编辑且默认的 `low` 保真度无法实现，请将其设置为 `high`。 ## 输出 - `data[]` 列表，每张图像包含 `b64_json` ## 限制与说明 - 输入图像和遮罩必须小于 50MB。 - 当用户要求更改现有图像时，请使用编辑端点。 - 遮罩是提示词引导的；不保证精确形状。 - 大尺寸和高质量会增加延迟和成本。 - 对于快速迭代或对延迟敏感的运行，从 `quality=low` 开始；对于文本密集或细节关键的输出，提高到 `high`。 - 对于严格的编辑（身份保留、布局锁定或精确合成），请使用 `input_fidelity=high`。