Edit 3.0（编辑）

OpenAPI Specification

接口：POST /ideogram/v1/ideogram-v3/edit（完整地址 https://api.allyang.cn/ideogram/v1/ideogram-v3/edit）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

accept：必填，string，示例取值 application/json。

请求体（multipart/form-data）

prompt：必填，string，编辑提示。
image：必填，binary，待编辑的原图。
mask：必填，binary，蒙版，用于标出需要改动的区域。
rendering_speed：可选，string，渲染速度档位。
character_reference_images：可选，binary，用于保持角色一致性，支持多图。

响应

500：文档中该状态码标注为「成功」，返回 JSON 对象：code（string）、message（string）、data（原文声明为 null 类型）。
返回的图片 URL 在 24 小时内有效，过期后无法访问；图片已由平台反向代理。

响应示例字段：created（string，创建时间）、resolution（string，图片分辨率）、is_image_safe（boolean，内容安全标记）、seed（integer，随机种子）、url（string，图片地址，示例已脱敏）、style_type（string，风格类型，示例 GENERAL）。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。