Ideogram 角色重混

使用 ideogram/character-remix 生成内容

curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "ideogram/character-remix",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "鱼眼镜头自拍照片，拍摄于夜晚的城市街道。画面为圆形，带有黑色边框，画面中人物佩戴深色墨镜、身穿黑色夹克，手持银色数码相机举到面前拍摄倒影。背景可见一排关闭的店面卷帘门，上方有红色霓虹灯光。街道空无一人、光线昏暗，路灯在人行道上投射出暖光。鱼眼效果形成弯曲的畸变视角，让街道和建筑的直线呈现弧度。画面以红色和深色调为主，营造出氛围感拉满的都市情绪。人物倒影露出深色长发，位于圆形画面正中央。背景中多扇店面卷帘门形成重复的水平线条纹理。整体构图具有电影质感，昏暗街道与上方亮灯的店面形成强烈对比。",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp",
    "reference_image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "image_size": "square_hd",
    "num_images": "1",
    "strength": 0.8,
    "negative_prompt": "",
    "image_urls": [],
    "reference_mask_urls": ""
  }
}
'

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_ideogram_1765179916266"
  }
}

POST

api

jobs

createTask

使用 ideogram/character-remix 生成内容

curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "ideogram/character-remix",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "鱼眼镜头自拍照片，拍摄于夜晚的城市街道。画面为圆形，带有黑色边框，画面中人物佩戴深色墨镜、身穿黑色夹克，手持银色数码相机举到面前拍摄倒影。背景可见一排关闭的店面卷帘门，上方有红色霓虹灯光。街道空无一人、光线昏暗，路灯在人行道上投射出暖光。鱼眼效果形成弯曲的畸变视角，让街道和建筑的直线呈现弧度。画面以红色和深色调为主，营造出氛围感拉满的都市情绪。人物倒影露出深色长发，位于圆形画面正中央。背景中多扇店面卷帘门形成重复的水平线条纹理。整体构图具有电影质感，昏暗街道与上方亮灯的店面形成强烈对比。",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp",
    "reference_image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "image_size": "square_hd",
    "num_images": "1",
    "strength": 0.8,
    "negative_prompt": "",
    "image_urls": [],
    "reference_mask_urls": ""
  }
}
'

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_ideogram_1765179916266"
  }
}

查询任务状态

提交任务后，可通过统一的查询端点查看任务进度并获取生成结果：

Get Task Details

了解如何查询任务状态并获取生成结果

生产环境中，建议使用 callBackUrl 参数接收生成完成的自动通知，而非轮询状态端点。

Market Overview

浏览所有可用模型

Common API

查看账户积分与使用情况

Authorizations

Authorization

string

header

required

所有 API 都需要通过 Bearer Token 进行身份验证。

获取 API Key：

访问 API Key 管理页面获取您的 API Key

使用方法：在请求头中添加： Authorization: Bearer YOUR_API_KEY

注意事项：

请妥善保管您的 API Key，切勿泄露给他人
若怀疑 API Key 泄露，请立即在管理页面重置

Body

application/json

model

enum<string>

default:ideogram/character-remix

required

用于生成任务的模型名称。必填字段。

该端点必须使用 ideogram/character-remix 模型

可用选项:

ideogram/character-remix

Example:

"ideogram/character-remix"

callBackUrl

string<uri>

接收生成任务完成通知的回调 URL。可选配置，建议在生产环境中使用。

任务生成完成后，系统会向该 URL POST 任务状态与结果
回调内容包含生成的资源 URL 与任务相关信息
您的回调端点需要支持接收带 JSON 负载的 POST 请求
也可以选择调用任务详情端点，主动轮询任务状态

Example:

"https://your-domain.com/api/callback"

input

object

生成任务的输入参数

显示子属性

input.prompt

string

required

用于图像重混创作的文本提示词（最大长度：5000 字符）

Maximum string length: 5000

Example:

"鱼眼镜头自拍照片，拍摄于夜晚的城市街道。画面为圆形，带有黑色边框，画面中人物佩戴深色墨镜、身穿黑色夹克，手持银色数码相机举到面前拍摄倒影。背景可见一排关闭的店面卷帘门，上方有红色霓虹灯光。街道空无一人、光线昏暗，路灯在人行道上投射出暖光。鱼眼效果形成弯曲的畸变视角，让街道和建筑的直线呈现弧度。画面以红色和深色调为主，营造出氛围感拉满的都市情绪。人物倒影露出深色长发，位于圆形画面正中央。背景中多扇店面卷帘门形成重复的水平线条纹理。整体构图具有电影质感，昏暗街道与上方亮灯的店面形成强烈对比。"

input.image_url

string

required

待重混创作的基础图像 URL。（为上传后的文件 URL，非文件内容；支持的类型：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

Example:

"https://file.aiquickdraw.com/custom-page/akr/section-images/1755768466167d0tiuc6e.webp"

input.reference_image_urls

string<uri>[]

required

作为人物参考的图像集合。目前仅支持 1 张图像，其余图像将被忽略。（所有参考图像总大小不超过 10MB）。图像格式需为 JPEG、PNG 或 WebP（为上传后的文件 URL，非文件内容；支持的类型：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

Example:

[
  "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768479029sugx0g6f.webp"
]

input.rendering_speed

enum<string>

default:BALANCED

渲染速度。默认值："BALANCED"

可用选项:

TURBO,

BALANCED,

QUALITY

Example:

"BALANCED"

input.style

enum<string>

default:AUTO

生成图像的风格类型。不可与 style_codes 同时使用。默认值："AUTO"

可用选项:

AUTO,

REALISTIC,

FICTION

Example:

"AUTO"

input.expand_prompt

boolean

是否启用 MagicPrompt 功能优化生成请求。默认值：true（布尔值：true/false）

Example:

true

input.image_size

enum<string>

default:square_hd

生成图像尺寸规格

可用选项:

square,

square_hd,

portrait_4_3,

portrait_16_9,

landscape_4_3,

landscape_16_9

Example:

"square_hd"

input.num_images

enum<string>

default:1

生成图像数量

可用选项:

1,

2,

3,

4

Example:

"1"

input.seed

integer

随机数生成器的种子值

input.strength

number

default:0.8

基础图像在重混创作中的影响力权重。默认值：0.8（最小值：0.1，最大值：1，步长：0.1）

必填范围: 0.1 <= x <= 1

Example:

0.8

input.negative_prompt

string

需从生成图像中排除的内容描述。提示词中的描述优先级高于反向提示词。默认值：""（最大长度：500 字符）

Maximum string length: 500

Example:

""

input.image_urls

string<uri>[]

作为风格参考的图像集合（所有风格参考图像总大小不超过 10MB）。图像格式需为 JPEG、PNG 或 WebP（为上传后的文件 URL，非文件内容；支持的类型：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

Example:

[]

input.reference_mask_urls

string

应用于人物参考图像的蒙版集合。目前仅支持 1 张蒙版，其余蒙版将被忽略。（所有人物参考蒙版总大小不超过 10MB）。蒙版格式需为 JPEG、PNG 或 WebP（为上传后的文件 URL，非文件内容；支持的类型：image/jpeg、image/png、image/webp；最大文件大小：10.0MB）

Example:

""

Response

请求成功

code

enum<integer>

响应状态码

200: 成功 - 请求已处理完成
401: 未授权 - 身份验证凭据缺失或无效
402: 积分不足 - 账户积分不足以执行该操作
404: 未找到 - 请求的资源或端点不存在
422: 验证错误 - 请求参数未通过校验
429: 速率限制 - 已超出该资源的请求频次限制
455: 服务不可用 - 系统正在维护中
500: 服务器错误 - 处理请求时发生意外故障
501: 生成失败 - 内容生成任务执行失败
505: 功能禁用 - 当前请求的功能暂未开放

可用选项:

200,

401,

402,

404,

422,

429,

455,

500,

501,

505

msg

string

响应消息，请求失败时为错误描述

Example:

"success"

data

object

显示子属性

data.taskId

string

任务 ID，可用于调用任务详情端点查询任务状态

Example:

"task_ideogram_1765179916266"

Ideogram 角色编辑 Ideogram 角色图像生成

⌘I

图像系列

视频系列

音频系列

Ideogram 角色重混

查询任务状态

Get Task Details

相关资源

Market Overview

Common API

Authorizations

Body

Response

图像系列

视频系列

音频系列

​查询任务状态

Get Task Details

​相关资源

Market Overview

Common API

Authorizations

Body

Response

查询任务状态

相关资源