Remix（混合图） - 云雾API 接口对接

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Content-Type

string

必需

示例值:

application/json

Accept

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数multipart/form-data

image_request

string

可选

"prompt": "a beautiful sunset over mountains", // 用于生成图像的提示词 (必填)
"aspect_ratio": "ASPECT_16_9", // 图像宽高比 (可选) 可选值:ASPECT_10_16/ASPECT_16_10/ASPECT_9_16/ASPECT_16_9/ASPECT_3_2/ASPECT_2_3/ASPECT_4_3/ASPECT_3_4/ASPECT_1_1/ASPECT_1_3/ASPECT_3_1
"color_palette": { // 颜色调色板 (可选)
"name": "FRESH" // 预设调色板名称 (与members二选一) 可选值:EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE
// 或者使用自定义颜色:
/"members": [
{
"color_hex": "#FF0000", // 颜色十六进制值 (必填)
"color_weight": 1.0 // 颜色权重 (可选) 范围:0.05-1.0
}
]/
},
"image_weight": 50, // 图像权重 (可选) 范围:1-100,默认50
"magic_prompt_option": "AUTO", // 是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF
"model": "V_2", // 使用的模型 (可选) 默认V_2,可选值:V_1/V_1_TURBO/V_2/V_2_TURBO
"negative_prompt": "clouds,blur", // 反向提示词 (可选) 描述不想在图像中出现的内容
"num_images": 1, // 生成图片数量 (可选) 范围:1-8,默认1
"resolution": "RESOLUTION_1024_1024", // 分辨率 (可选) 可选值包含从512x1536到1536x640等多种分辨率组合
"seed": 123456, // 随机种子 (可选) 范围:0-2147483647
"style_type": "REALISTIC" // 风格类型 (可选) 可选值:AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME

示例值:

{ "image_weight": 50, "model": "V_1", "magic_prompt_option": "AUTO", "prompt": "A%20serene%20tropical%20beach%20", "aspect_ratio": "ASPECT_10_16", "seed": 12345, "negative_prompt": "brush%20strokes%2C%20painting" }

image_file

file

可选

图片文件 (必填) 用于生成新图像的源图片文件

示例值:

file://E:\zuomian\微信截图_20241130193920.png

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://yunwu.ai/ideogram/remix' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--form 'image_request="{
    \"image_weight\": 50,
    \"model\": \"V_1\",
    \"magic_prompt_option\": \"AUTO\",
    \"prompt\": \"A%20serene%20tropical%20beach%20\",
    \"aspect_ratio\": \"ASPECT_10_16\",
    \"seed\": 12345,
    \"negative_prompt\": \"brush%20strokes%2C%20painting\"
}"' \
--form 'image_file=@"E:\\zuomian\\微信截图_20241130193920.png"'

返回响应

🟢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
  }
}