官方文档:https://developer.ideogram.ai/api-reference/api-reference/remix
POST
/ideogram/remixRemix(混合图)
API Key multipart/form-data
请求示例
curl -X POST https://top.qingyuntop.ai/ideogram/remix \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Content-Type | Header | string | 是 | - | multipart/form-data |
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 是 | - | Bearer {{YOUR_API_KEY}} |
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://C:\Users\Administrator\Desktop\例子.png |
model | JSON body | string | 是 | 使用的模型,可选,默认为 kling-image | - |
prompt | JSON body | string | 是 | 正向提示词,必需,描述你想要生成的图像内容,不能超过500个字符 | - |
negative_prompt | JSON body | string | 是 | 负向提示词,可选,描述你不想在图像中出现的元素,不能超过200个字符 | - |
image | JSON body | string | 是 | 参考图片,可选,支持 Base64 编码或图片 URL,支持 .jpg/.jpeg/.png 格式,大小不能超过 10MB | - |
image_fidelity | JSON body | number | 是 | 参考图片的影响强度,可选,取值范围:0-1,值越大,生成的图像越接近参考图片 | - |
n | JSON body | integer | 是 | 生成图片的数量,可选,取值范围:1-9 | - |
aspect_ratio | JSON body | string | 是 | 生成图片的纵横比,可选,可选值:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | - |
callback_url | JSON body | string | 是 | 回调通知地址,可选,当任务状态发生变化时,系统会向这个地址发送通知 | - |
返回响应 (200)
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
code | 响应 JSON | integer | 是 | - | - |
message | 响应 JSON | string | 是 | - | - |
request_id | 响应 JSON | string | 是 | - | - |
data | 响应 JSON | object | 是 | - | - |
data.task_id | 响应 JSON | string | 是 | - | - |
data.task_status | 响应 JSON | string | 是 | - | - |
data.created_at | 响应 JSON | integer | 是 | - | - |
data.updated_at | 响应 JSON | integer | 是 | - | - |
响应示例
{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}来源原始接口定义(用于追溯)
以下内容来自 Apifox 快照,可能包含兼容层字段或旧示例;公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899665,
"name": "Remix(混合图)",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "官方文档:https://developer.ideogram.ai/api-reference/api-reference/remix",
"operationId": "",
"sourceUrl": "",
"method": "post",
"path": "/ideogram/remix",
"tags": [],
"status": 1,
"requestBody": {
"type": "multipart/form-data",
"parameters": [
{
"id": "LwWFrt4lCi",
"name": "image_request",
"required": false,
"enable": true,
"description": "\"prompt\": \"a beautiful sunset over mountains\", // 用于生成图像的提示词 (必填)\n \"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\n \"color_palette\": { // 颜色调色板 (可选)\n \"name\": \"FRESH\" // 预设调色板名称 (与members二选一) 可选值:EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE\n // 或者使用自定义颜色:\n /*\"members\": [\n {\n \"color_hex\": \"#FF0000\", // 颜色十六进制值 (必填) \n \"color_weight\": 1.0 // 颜色权重 (可选) 范围:0.05-1.0\n }\n ]*/\n },\n \"image_weight\": 50, // 图像权重 (可选) 范围:1-100,默认50\n \"magic_prompt_option\": \"AUTO\", // 是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF\n \"model\": \"V_2\", // 使用的模型 (可选) 默认V_2,可选值:V_1/V_1_TURBO/V_2/V_2_TURBO\n \"negative_prompt\": \"clouds,blur\", // 反向提示词 (可选) 描述不想在图像中出现的内容\n \"num_images\": 1, // 生成图片数量 (可选) 范围:1-8,默认1\n \"resolution\": \"RESOLUTION_1024_1024\", // 分辨率 (可选) 可选值包含从512x1536到1536x640等多种分辨率组合\n \"seed\": 123456, // 随机种子 (可选) 范围:0-2147483647\n \"style_type\": \"REALISTIC\" // 风格类型 (可选) 可选值:AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME",
"type": "string",
"sampleValue": "{ \"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\"}"
},
{
"id": "rxHGz5ilvI",
"name": "image_file",
"required": false,
"enable": true,
"description": " 图片文件 (必填) 用于生成新图像的源图片文件",
"type": "file",
"sampleValue": "file://C:\\Users\\Administrator\\Desktop\\例子.png"
}
],
"jsonSchema": {
"type": "object",
"properties": {
"model": {
"description": "使用的模型,可选,默认为 kling-image",
"type": "string"
},
"prompt": {
"description": "正向提示词,必需,描述你想要生成的图像内容,不能超过500个字符",
"type": "string"
},
"negative_prompt": {
"description": "负向提示词,可选,描述你不想在图像中出现的元素,不能超过200个字符",
"type": "string"
},
"image": {
"description": "参考图片,可选,支持 Base64 编码或图片 URL,支持 .jpg/.jpeg/.png 格式,大小不能超过 10MB",
"type": "string"
},
"image_fidelity": {
"description": "参考图片的影响强度,可选,取值范围:0-1,值越大,生成的图像越接近参考图片",
"type": "number"
},
"n": {
"description": "生成图片的数量,可选,取值范围:1-9",
"type": "integer"
},
"aspect_ratio": {
"description": "生成图片的纵横比,可选,可选值:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3",
"type": "string"
},
"callback_url": {
"description": "回调通知地址,可选,当任务状态发生变化时,系统会向这个地址发送通知",
"type": "string"
}
},
"required": [
"model",
"prompt",
"negative_prompt",
"image",
"image_fidelity",
"n",
"aspect_ratio",
"callback_url"
],
"x-apifox-orders": [
"model",
"prompt",
"negative_prompt",
"image",
"image_fidelity",
"n",
"aspect_ratio",
"callback_url"
]
},
"examples": [
{
"value": "",
"mediaType": "multipart/form-data",
"description": ""
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [],
"cookie": [],
"header": [
{
"id": "NQs7bxnpZf",
"name": "Content-Type",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "multipart/form-data"
},
{
"id": "qb8tEQbCty",
"name": "Accept",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "gBxcCbXhsa",
"name": "Authorization",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "Bearer {{YOUR_API_KEY}}"
}
]
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {
"type": "noauth"
},
"responses": [
{
"id": 196932620,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {
"code": {
"type": "integer"
},
"message": {
"type": "string"
},
"request_id": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"task_id": {
"type": "string"
},
"task_status": {
"type": "string"
},
"created_at": {
"type": "integer"
},
"updated_at": {
"type": "integer"
}
},
"required": [
"task_id",
"task_status",
"created_at",
"updated_at"
],
"x-apifox-orders": [
"task_id",
"task_status",
"created_at",
"updated_at"
]
}
},
"required": [
"code",
"message",
"request_id",
"data"
],
"x-apifox-orders": [
"code",
"message",
"request_id",
"data"
]
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": [],
"oasExtensions": ""
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 196932620,
"data": "{\r\n \"code\": 0,\r\n \"message\": \"SUCCEED\",\r\n \"request_id\": \"CjMT7WdSwWcAAAAAALvB3g\",\r\n \"data\": {\r\n \"task_id\": \"CjMT7WdSwWcAAAAAALvB3g\",\r\n \"task_status\": \"submitted\",\r\n \"created_at\": 1733851336696,\r\n \"updated_at\": 1733851336696\r\n }\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b13-775e-923c-0754f50d59a2"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436106,
"ordering": 36,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {},
"isDefaultUrlEncoding": 1
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-06T12:15:55.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}