POST/ideogram/remix

Remix（混合图）

官方文档：https://developer.ideogram.ai/api-reference/api-reference/remix

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/remix

Body

必填

Bodyobject

modelstring必填

使用的模型，可选，默认为 kling-image

promptstring必填

正向提示词，必需，描述你想要生成的图像内容，不能超过500个字符

negative_promptstring必填

负向提示词，可选，描述你不想在图像中出现的元素，不能超过200个字符

imagestring必填

参考图片，可选，支持 Base64 编码或图片 URL，支持 .jpg/.jpeg/.png 格式，大小不能超过 10MB

image_fidelitynumber必填

参考图片的影响强度，可选，取值范围：0-1，值越大，生成的图像越接近参考图片

ninteger必填

生成图片的数量，可选，取值范围：1-9

aspect_ratiostring必填

生成图片的纵横比，可选，可选值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

callback_urlstring必填

回调通知地址，可选，当任务状态发生变化时，系统会向这个地址发送通知

image_requeststring

"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_filefile

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

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

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	是	-	multipart/form-data
`Accept`	Header	string	是	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例multipart/form-data

curl -X POST https://top.qingyuntop.ai/ideogram/remix \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: multipart/form-data" \
  -d '{
  "model": "",
  "prompt": "",
  "negative_prompt": "",
  "image": "",
  "image_fidelity": 0,
  "n": 0,
  "aspect_ratio": "",
  "callback_url": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

codeinteger必填

messagestring必填

request_idstring必填

dataobject必填

task_idstring必填

task_statusstring必填

created_atinteger必填

updated_atinteger必填

响应示例json

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

Ideogram 兼容协议

调用与返回说明

请求时注意

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

返回时注意

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

Remix（混合图）

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

返回响应 `200`