Replace Background 3.0（背景替换）

OpenAPI Specification

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

鉴权：请求头 Authorization 传令牌，取值形如 Bearer {{YOUR_API_KEY}}（该字段非必填）。

请求头

• accept：必填，固定 application/json。

请求体（multipart/form-data）

• prompt：string，必传；用来描述替换后的背景。
• image：binary，必传；待处理的原图。
• rendering_speed：string，可选；渲染速度档位。

响应

• 原文档只标注了 500 状态码；响应体包含 code（string）、message（string）与 data（null）。
• 示例返回里另外出现 created，以及 data[] 下的 prompt、resolution、is_image_safe、seed、url、style_type（示例图片地址统一记作 https://example.com/...）。

其他说明

• 该接口会保留画面中的前景主体，只按提示词与所选样式更换背景；可用的图片格式为 JPEG、PNG、WebP。
• 原文档提醒：返回的图片地址存在有效期，超过 24 小时后将无法访问，需要长期保存请及时下载。

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