青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/ideogram/v1/ideogram-v3/replace-background

Generate 3.0（替换背景） Replace Background

使用 Ideogram 3.0 模型，根据给定的提示和可选参数同步生成图像 具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/replace-background-v3 返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。 已反代图片

API Key multipart/form-data
Ideogram 兼容协议

调用与返回说明

这是本站提供的 Ideogram 兼容入口，路径沿用厂商动作命名。它不是让客户端直接访问 Ideogram，也不要求提交厂商 API Key；当前可用模型和权限以本站配置为准。

请求时注意

  • 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
  • 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。

返回时注意

  • 同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
  • URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。
Request

请求

/ideogram/v1/ideogram-v3/replace-background

Body

必填
Body
Bodyobject
promptstring必填

生成图像所需的提示文本

示例Add a forest in the background
seedinteger

随机种子。设置此值可获得可重复的生成结果

范围：[0，2147483647]
resolutionstring

支持的分辨率选项

可选值：512x1536、576x1408、576x1472、576x1536、640x1344、640x1408、640x1472、640x1536、704x1152、704x1216、704x1280、704x1344、704x1408、704x1472、736x1312、768x1088、768x1216、768x1280、768x1344、800x1280、832x960、832x1024、832x1088、832x1152、832x1216、832x1248、864x1152、896x960、896x1024、896x1088、896x1120、896x1152、960x832、960x896、960x1024、960x1088、1024x832、1024x896、1024x960、1024x1024、1088x768、1088x832、1088x896、1088x960、1120x896、1152x704、1152x832、1152x864、1152x896、1216x704、1216x768、1216x832、1248x832、1280x704、1280x768、1280x800、1312x736、1344x640、1344x704、1344x768、1408x576、1408x640、1408x704、1472x576、1472x640、1472x704、1536x512、1536x576、1536x640
aspect_ratiostring

用于图像生成的纵横比，决定图像的分辨率。不能与resolution参数同时使用。默认为1x1

可选值：1x3、3x1、1x2、2x1、9x16、16x9、10x16、16x10、2x3、3x2、3x4、4x3、4x5、5x4、1x1
rendering_speedstring

渲染速度选项

可选值：TURBO、DEFAULT、QUALITY默认：DEFAULT
magic_promptstring

决定是否在生成请求时使用Magic Prompt

可选值：AUTO、ON、OFF
negative_promptstring

描述要在图像中排除的内容。提示中的描述优先于负面提示中的描述

num_imagesinteger

要生成的图像数量

默认：1范围：[1，8]
color_paletteobject

生成的颜色调色板，必须通过预设之一（name）或通过带有可选权重的颜色的十六进制表示（members）明确指定

满足其中一个分支
分支 1object
不允许额外字段
namestring必填

预设调色板名称

style_codesarray<string>

表示图像风格的8字符十六进制代码列表。不能与style_reference_images或style_type一起使用

元素string
格式：^[0-9A-Fa-f]{8}$
style_typestring

要生成的风格类型

可选值：AUTO、GENERAL、REALISTIC、DESIGN默认：GENERAL
imagefile必填

图像正在重新处理（最大大小为 10 兆字节）；目前仅支持 JPEG、WebP 和 PNG 格式。

示例file://C:\Users\Administrator\Desktop\例子.png

路径、查询与 Header 参数

参数位置类型必填说明示例
AcceptHeaderstring是-application/json
AuthorizationHeaderstring是必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。Bearer YOUR_API_KEY
Response

返回响应 200

HTTP 响应
响应 200json
响应 200object
codeinteger必填
messagestring必填
request_idstring必填
dataobject必填
task_idstring必填
task_statusstring必填
created_atinteger必填
updated_atinteger必填
Ideogram 兼容协议

调用与返回说明

这是本站提供的 Ideogram 兼容入口，路径沿用厂商动作命名。它不是让客户端直接访问 Ideogram，也不要求提交厂商 API Key；当前可用模型和权限以本站配置为准。

请求时注意

  • 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
  • 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。

返回时注意

  • 同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
  • URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。