Generate 3.0（替换背景） Replace Background

POST

https://yunwu.ai/ideogram/v1/ideogram-v3/replace-background

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数multipart/form-data

image

file

必需

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

示例值:

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

prompt

string

可选

示例值:

Add a forest in the background

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://yunwu.ai/ideogram/v1/ideogram-v3/replace-background' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--form 'image=@"C:\\Users\\Administrator\\Desktop\\例子.png"' \
--form 'prompt="Add a forest in the background"'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

request_id

string

必需

data

object

必需

task_id

string

必需

task_status

string

必需

created_at

integer

必需

updated_at

integer

必需

示例

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CjMT7WdSwWcAAAAAALvB3g",
    "data": {
        "task_id": "CjMT7WdSwWcAAAAAALvB3g",
        "task_status": "submitted",
        "created_at": 1733851336696,
        "updated_at": 1733851336696
    }
}

修改于 2025-05-14 10:36:27

Generate 3.0（图片重构）Reframe

ideogram（文生图）