Ideogram 角色图像生成

使用 ideogram/character 生成内容

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",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "将上传肖像中的这位女性（身着休闲白衬衫）置于宁静的花园场景中。画面需呈现生机盎然的绿植与缤纷花卉，柔和的阳光透过枝叶洒落。她坐在木质长椅上，手持书本，浅笑嫣然。背景被葱郁的绿植填满，营造出静谧祥和的氛围。午后的金色光线勾勒出她的脸庞，在地面投下柔和的阴影，为整个画面增添悠然、沉思的意境。",
    "reference_image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1755767145415pvz49dpi.webp"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "num_images": "1",
    "image_size": "square_hd",
    "negative_prompt": ""
  }
}
'

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

POST

api

jobs

createTask

使用 ideogram/character 生成内容

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",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "将上传肖像中的这位女性（身着休闲白衬衫）置于宁静的花园场景中。画面需呈现生机盎然的绿植与缤纷花卉，柔和的阳光透过枝叶洒落。她坐在木质长椅上，手持书本，浅笑嫣然。背景被葱郁的绿植填满，营造出静谧祥和的氛围。午后的金色光线勾勒出她的脸庞，在地面投下柔和的阴影，为整个画面增添悠然、沉思的意境。",
    "reference_image_urls": [
      "https://file.aiquickdraw.com/custom-page/akr/section-images/1755767145415pvz49dpi.webp"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "num_images": "1",
    "image_size": "square_hd",
    "negative_prompt": ""
  }
}
'

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

查询任务状态

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

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

required

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

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

可用选项:

ideogram/character

Example:

"ideogram/character"

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.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/1755767145415pvz49dpi.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.num_images

enum<string>

default:1

生成图像数量

可用选项:

1,

2,

3,

4

Example:

"1"

input.image_size

enum<string>

default:square_hd

生成图像的分辨率规格。默认值：square_hd

可用选项:

square,

square_hd,

portrait_4_3,

portrait_16_9,

landscape_4_3,

landscape_16_9

Example:

"square_hd"

input.seed

integer

随机数生成器的种子值

input.negative_prompt

string

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

Maximum string length: 5000

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

Ideogram 角色重混 Qwen 文生图

⌘I

图像系列

视频系列

音频系列

Ideogram 角色图像生成

查询任务状态

Get Task Details

相关资源

Market Overview

Common API

Authorizations

Body

Response

图像系列

视频系列

音频系列

​查询任务状态

Get Task Details

​相关资源

Market Overview

Common API

Authorizations

Body

Response

查询任务状态

相关资源