上传 1 张角色参考图，让同一个角色出现在夜市、海边、咖啡馆等新场景。在 HiAPI 在线试用 Ideogram 3.0 Character，查看案例、三档计费说明与异步 API 接入示例。
提供商: Ideogram
类型: 图像生成
接口: /v1/tasks
状态: 已开放
消耗: 查看页面实时价格
上传 1 张角色参考图，让同一个角色出现在夜市、海边、咖啡馆等新场景。在 HiAPI 在线试用 Ideogram 3.0 Character，查看案例、三档计费说明与异步 API 接入示例。
定价
标准用量
不希望出现的内容，最多 5000 个字符
TURBO 最快、BALANCED 默认、QUALITY 细节最好，三档分别计价
AUTO 自动；REALISTIC 写实；FICTION 插画 / 虚构风格
用 MagicPrompt 自动扩写提示词
准备生成
配置参数并点击"运行"查看输出结果。
每个案例分别展示参考图、编辑指令和完整结果，支持放大图片与复制提示词。
1 张参考图 / 1328 × 752
灯笼夜市里，同一个小探险家捧着热面走过摊位；横版参考图直接得到横版画面。
The explorer character walking through a lantern-lit night market, holding a paper cup of hot noodles, warm glowing stalls on both sides, storybook illustration, no text, no signs
1 张参考图 / 1328 × 752
海风、海鸥与红色风筝，黄色雨衣、圆眼镜和背包在新场景中保持一致。
The explorer character flying a red kite on a wide windy beach, kite string stretching across the sky, seagulls, soft afternoon light, storybook illustration, no text
1 张参考图 / 1328 × 752
用一张写实人物照片作参考，配合 REALISTIC 风格，把同一个人放进咖啡馆的工作场景。
The same man working as a barista in a sunlit neighborhood cafe, pouring latte art into a ceramic cup, wearing a canvas apron, shallow depth of field, photorealistic, no text
1 张参考图 / 864 × 1152
雨夜站台、湿地砖反光与暖色灯光，竖版参考图对应竖版 864×1152 输出。
The explorer character reading a paper map on a rainy night train platform, glowing lamps, reflections on wet tiles, cinematic, no text, no signs
1 张参考图 / 864 × 1152
明亮的夏日花田，角色的发色、服装与表情风格保持统一。
The explorer character laughing in a vast sunflower field under a bright blue summer sky, holding the backpack straps, no text
1 张参考图 / 864 × 1152
BALANCED 档：海边公路骑行，角色在动态姿势中保持一致。
The same explorer character riding a red bicycle along a seaside cliff road at sunset, wind in the hair, warm golden light, wide shot, no text
根据任务类型、输出档位和参考图需求选择相邻模型。
上传 1 张角色参考图，让同一个角色出现在夜市、海边、咖啡馆等新场景。在 HiAPI 在线试用 Ideogram 3.0 Character，查看案例、三档计费说明与异步 API 接入示例。
本页 Playground 和 API 使用同一个模型 ID：ideogram-v3-character。参考图提供人物、产品、场景或风格事实，提示词负责分配每张图的作用并限定修改范围。
为 Ideogram 3.0 Character 选择适合创作目标的输入与输出设置。
每次固定输出 1 张图片；角色参考图、原图与蒙版不另收费。失败任务不扣费，以页面实时价格为准。
参考图负责提供事实，提示词负责分配每张图的角色并限定修改范围。
选一张角色清晰、背景简单的图片；插画、吉祥物和写实人像都可以。参考图的横竖决定输出画幅。
用固定称呼指代角色，例如 the same boy，再写场景、动作、道具与光线。
探索
TURBO
定稿
QUALITY
TURBO 快速探索、BALANCED 日常出图、QUALITY 定稿；style 可选 AUTO / REALISTIC / FICTION。
下面是可直接复制的最小请求；完整参数、回调、查询与错误码请查看 Docs。
POST /v1/tasksideogram-v3-charactercurl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v3-character",
"input": {
"prompt": "The explorer character walking through a lantern-lit night market, holding a paper cup of hot noodles, warm glowing stalls on both sides, storybook illustration, no text, no signs",
"reference_image_urls": [
"https://static.hiapi.ai/gallery/2026/10/156346d531f0b319.jpg"
],
"rendering_speed": "TURBO"
}
}'创建请求会立即返回 taskId；图像生成在后台异步完成。
一张参考图，一个固定的角色
Ideogram 3.0 Character 专门解决“角色一致性”：上传 1 张角色参考图，再用文字描述新的场景、动作和氛围，模型会尽量保留发型、服装、配色和面部特征，把同一个角色放进夜市、海边、站台或咖啡馆。
在 HiAPI 上它分为两个模型：ideogram-v3-character 负责从参考图生成新画面；ideogram-v3-character/edit 用原图和蒙版，只把角色重绘进指定区域。本页案例可以放大查看并复制原始提示词。
案例横览
左右滑动浏览，每张卡片标出输出比例，并可复制完整提示词。
16:9The explorer character walking through a lantern-lit night market, holding a paper cup of hot noodles, warm glowing stalls on both sides, storybook illustration, no text, no signs
16:9The explorer character flying a red kite on a wide windy beach, kite string stretching across the sky, seagulls, soft afternoon light, storybook illustration, no text
16:9The same man working as a barista in a sunlit neighborhood cafe, pouring latte art into a ceramic cup, wearing a canvas apron, shallow depth of field, photorealistic, no text
3:4The explorer character reading a paper map on a rainy night train platform, glowing lamps, reflections on wet tiles, cinematic, no text, no signs
3:4The explorer character laughing in a vast sunflower field under a bright blue summer sky, holding the backpack straps, no text
3:4The same explorer character riding a red bicycle along a seaside cliff road at sunset, wind in the hair, warm golden light, wide shot, no text
一张参考，多种场景
左侧是唯一的角色参考图。右侧三张只改了提示词里的场景和动作：发色、雀斑、耳环与毛衣在不同光线和姿势中保持一致，背景和构图则完全换新。
连续角色故事
用同一张水彩风角色参考，依次写出“发现地图—走过吊桥—篝火夜—抵达灯塔”四段提示词。红围巾、绿外套和皮挎包贯穿每一格，适合绘本提案、分镜和系列插画。
01阁楼里发现藏宝图
02穿过雾中吊桥
03星空下的篝火
04黎明抵达灯塔
01 / 角色一致
参考图里是一个穿黄色雨衣、戴圆眼镜、背着帆布包的插画角色。换成夜市场景后，雨衣颜色、眼镜形状、背包和绿色短发都被保留下来，变化的只有动作、道具和环境光。
写提示词时用“the explorer character”这样的固定称呼指代参考角色，把篇幅留给场景、动作和光线，效果比重复描述外貌更稳定。
02 / 画幅
输出宽高比大致跟随角色参考图：竖版参考（768×1024）得到 864×1152 竖图，横版参考得到 1328×752 横图。接口没有单独的尺寸参数。
所以需要横版封面或 16:9 画面时，先把角色参考图扩展成横版（例如在两侧补背景），再提交生成。
03 / 写实人物
参考图换成一张写实人物照片，并把 style 设为 REALISTIC，同一个人被放进咖啡馆，正在给拿铁拉花。脸型、发型和衬衫质感延续自参考图。
写实场景建议在提示词里写清楚镜头、景深和光线；角色必须是参考图中清晰可见的主体。
参数对照
吉祥物参考、提示词和 seed 都相同，只切换 rendering_speed。TURBO 适合快速探索构图，BALANCED 是默认档，QUALITY 在毛发、旗帜和背景人群上更细致。具体费用见页面实时价格。
| 档位 | 效果 | 适合 |
|---|---|---|
| TURBO | 试方向、批量草稿 | |
| BALANCED | 日常出图（默认） | |
| QUALITY | 定稿、主视觉 |
同一位插画角色、同一提示词与 seed。差异主要体现在光影与质感：REALISTIC 更接近摄影光线，FICTION 保持更强的插画感；角色本身的服装和发色不变。
| 风格 | 效果 | 适合 |
|---|---|---|
| AUTO | 让模型按提示词自动判断 | |
| REALISTIC | 人像、商品和写实场景 | |
| FICTION | 绘本、游戏与卡通角色 |
一个主角贯穿整本书或整组分镜，换场景不换人。
同一吉祥物用于广告牌、包装、节日海报与社媒素材。
为虚拟人物持续产出不同地点、不同活动的系列图片。
当同一个角色需要在多张图里反复出现时，Ideogram 3.0 Character 可以减少逐张修图的工作量。
用一张角色设定图生成不同章节的场景，保持主角造型统一。
示例：花田、站台、夜市、海边四个场景
把吉祥物放进节日、门店或活动画面，减少重新绘制。
建议：TURBO 试方向，QUALITY 出定稿
用一张人物照片生成不同工作或生活场景，适合故事板与提案。
示例：书店 → 咖啡馆
以下要点对应本页案例。
CHARACTER EDIT
原图 + 蒙版 + 角色参考图，蒙版外的画面保持不变。
IDEOGRAM V4
标题、Logo 与标牌等文字排版场景可以进一步比较。
在上方 Playground 上传角色参考图即可生成；接入时通过 HiAPI /v1/tasks 接口提交，按张计费、失败不扣费。
不能单独指定。输出宽高比跟随角色参考图：竖版参考得到 864×1152，横版参考得到 1328×752。需要横图时，请上传横版角色参考图（例如在两侧补背景）。
选一张角色清晰、正面或四分之三侧面、背景简单的图片；插画和写实照片都可以。参考图里的服装和配色会尽量被保留。
用固定称呼指代角色（如 the explorer character / the same man），重点描述场景、动作、道具和光线；可以配合 style 选择 REALISTIC 或 FICTION。
可以。本页的橙色狐狸吉祥物就是用 1 张角色设计图生成广告牌、柜台和集市等不同场景，围巾和配色保持一致。
可以。每一格使用同一张角色参考图，只改提示词中的场景和动作；本页四格绘本故事就是这样完成的。
AUTO 由模型按提示词判断；REALISTIC 偏摄影光线与质感，适合人像和写实场景；FICTION 保持插画感，适合绘本、游戏和卡通角色。
固定 seed 便于复现和对比：同一参考图、提示词与 seed 下只切换档位或风格，就能直接比较差异。
output[].url 是带有效期的临时地址，请在任务成功后及时下载或转存到自己的存储。
TURBO 最快、单价最低，适合试方向和批量出草稿；BALANCED 是默认档；QUALITY 细节最好，适合定稿。三档使用同一个模型 ID，按张分别计价，具体价格见页面实时价格。
不可以。reference_image_urls 必须恰好 1 张。选一张角色清晰、全身或半身、背景干净的图片效果更稳定。
暂不支持。当前开放角色生成（ideogram-v3-character）和蒙版局部编辑（ideogram-v3-character/edit）。
失败任务不扣费。提交后保存 taskId，通过 GET /v1/tasks/:id 查询，status 为 success 后从 output[].url 下载 WebP；生产环境建议传 callback.url 接收终态通知，并及时保存结果。