
这是一套用于 Ideogram 4.6 API 的提示词,以完整请求体的形式写成,可以直接粘贴进代码:七个用 ideogram-v4.6 做文生图,三个用 ideogram-v4.6-edit 做编辑。每一个都列出了尺寸档位和价格,让你在发送之前就知道一次运行的成本。所有请求体都遵循 Ideogram 4.6 的 PoYo schema,并发送到 POST https://api.poyo.ai/api/generate/submit。
提示词 1 是我们在 2026 年 11 月 20 日发布当天测试中使用的原始请求。其余是我们没有运行过的模板;请把它们当作起点,并检查每一个输出。
如何编写 Ideogram 4.6 API 提示词
schema 允许最多 10,000 个字符,所以有足够空间写得具体。适合排版的提示词通常包含五个部分:
| 部分 | 示例 |
|---|---|
| 形式 | "Screen-printed concert poster"、"flat vector sticker"、"product label" |
| 精确文字,放在引号中,每行一个字符串 | "NORTHBOUND JAZZ FESTIVAL" |
| 每行的层级和位置 | "big bold headline at the top"、"a smaller line below the art" |
| 画面内容和配色 | "upright bass and saxophone over a river at dusk, teal, burnt orange and cream" |
| 质感收尾 | "fine paper grain, crisp letterforms, generous margins" |
提示词扩展始终开启,因此模型可能会添加细节。在我们的测试海报中,它在角落添加了一个小号的 "EST. 1987" 和一个网址。Ideogram 自己的建议是 "check spelling and placement in the final result"。
按阶段而不是按习惯选择设置:版式草稿用 very_low(1.6 积分,$0.008),默认用 medium(12 积分,$0.06),最终版用 high。除非需要印刷尺寸,否则控制在 4,194,304 像素或以下;超过这条线,每个质量的价格都会翻倍。
文生图提示词
1. 4K 活动海报(已测试)
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
"size": "2304x3072",
"quality": "high",
"n": 1
}
}
档位: 4K high,40 积分($0.20)。实测: 任务 M4WA9OIQXVV80DHG 返回了一张 2304×3072 PNG,三行文字都按原文渲染,包括那行小号斜体字。作为草稿,同一提示词配合 "quality": "very_low" 和 "size": "3:4" 返回了 768×1024 的图,费用 1.6 积分($0.008),文字正确,构图不同。
2. 一个请求生成多张版式草稿
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Minimal bookstore event flyer with the headline \"AUTHOR NIGHT\" in large serif capitals, the line \"Thursday 7 PM · Upstairs\" below it, and a simple line drawing of an open book. Off-white paper, black and brick red.",
"size": "3:4",
"quality": "very_low",
"n": 8
}
}
档位: 2K very_low,8 × 1.6 = 12.8 积分($0.064)。挑出你喜欢的版式,再用 high 和更大的尺寸重新运行。
3. 产品标签
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Front label for a small-batch hot sauce bottle, flat design, centered. Top line \"CASA FUEGO\" in a hand-painted script, middle line \"SMOKED HABANERO\" in bold sans-serif capitals, bottom line \"5 FL OZ · 148 ML\" in small type. Red, cream and charcoal, with a small chili illustration.",
"size": "1536x2048",
"quality": "medium"
}
}
档位: 2K medium(3,145,728 像素),12 积分($0.06)。
4. 带 seed 的透明贴纸
{
"model": "ideogram-v4.6",
"input": {
"prompt": "A die-cut sticker of a cheerful cactus wearing sunglasses, with the words \"STAY SHARP\" on a curved banner underneath. Thick white outline, flat colors.",
"size": "1:1 HD",
"quality": "low",
"background": "transparent",
"seed": 42
}
}
档位: 2K low,6 积分($0.03)。transparent 返回带 alpha 通道的图像。保持相同的 seed 和请求体即可复现结果。
5. 4:5 社交媒体语录卡片
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Instagram quote card. Large centered quote \"Ship small. Ship often.\" in a modern grotesk typeface, and below it a small line \"— The Release Notes Podcast\". Solid sage green background with a thin cream border.",
"size": "1024x1280",
"quality": "medium",
"n": 4
}
}
档位: 2K medium,4 × 12 = 48 积分($0.24)。1024x1280 是精确的 4:5 尺寸,两边都是 32 的倍数。
6. 16:9 视频缩略图
{
"model": "ideogram-v4.6",
"input": {
"prompt": "YouTube thumbnail, bold and high contrast. Left half: the text \"I BUILT A TINY CABIN\" in thick white capitals with a black outline, stacked on three lines. Right half: a small wooden cabin in a snowy forest at blue hour, warm light in the windows.",
"size": "2560x1440",
"quality": "high"
}
}
档位: 2K high(3,686,400 像素),20 积分($0.10)。比它更大的最大精确 16:9 尺寸 4096x2304 需要 40 积分。
7. 带招牌的店面场景
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Photograph of a corner bakery at sunrise, wet cobblestones, a hand-painted wooden sign above the door reading \"MORNING CRUMB\", and a chalkboard by the door reading \"Fresh rye today\". Natural light, 35mm look.",
"size": "16:9",
"quality": "medium"
}
}
档位: 2K medium,12 积分($0.06)。16:9 预设返回 1024×576;使用 2048x1152 这样的自定义尺寸,可以在同一价格档位获得更多细节。
编辑提示词
编辑使用 ideogram-v4.6-edit,image_urls 中恰好一张图。Ideogram 的页面建议分步骤修改文字,所以每次编辑只做一件事,并说明哪些必须保持不变。
8. 修改一行文字,其余保持不变
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
"image_urls": [
"https://example.com/northbound-poster.png"
],
"edit_precision": "high",
"context_window": "none",
"size": "auto",
"quality": "high",
"n": 1
}
}
档位: 跟随源图尺寸。实测: 在我们的 2304×3072 海报上(任务 672JRU198S22NS8D),输出保持 2304×3072,所有变化的像素都在日期行周围的一个框内,约占图像的 1.1%,扣费 120 积分($0.60)。如果源图不超过 4,194,304 像素,则为 44 积分($0.22)。
9. 把产品改成品牌色
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Recolor the ceramic mug to the exact brand blue #1E6FD9. Keep the mug's shape, handle, shadows, the table and the background exactly the same.",
"image_urls": [
"https://example.com/mug.png"
],
"edit_precision": "high",
"quality": "medium"
}
}
档位: medium 编辑,源图不超过 4,194,304 像素时为 12 积分($0.06),超过则为 40 积分。Ideogram 报告,在高质量档下其 "exact color" 任务的可用结果为 83%,高于 Ideogram 4.5 的 46%。
10. 参照参考图修改材质
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change the toy car's body to brushed copper like the reference image. Keep the scene, lighting and camera angle the same.",
"image_urls": [
"https://example.com/toy-car.png"
],
"reference_image_urls": [
"https://example.com/copper-swatch.png"
],
"quality": "low",
"n": 2
}
}
档位: low 质量的普通编辑,输出不超过 4,194,304 像素时为 2 × 6 = 12 积分($0.06)。普通编辑会重新生成图像,因此允许 background 和自定义 size;当其余部分必须像素级不变时,请切换到 edit_precision: high。
把提示词变成模板
大多数应用不会发送一个固定的提示词;它们会用用户的活动名称、产品或日期来填充模板。把带引号的字符串保存为独立变量,这样你可以在请求发出前校验它们,之后的编辑(提示词 8)也可以按精确的文字定位到其中某一个。几条规则能让模板既便宜又可预期:
- 转义用户文本中的引号。 提示词是一个 JSON 字符串,一个多余的
"就会破坏请求体。用 JSON 库构建请求体,而不是拼接字符串。 - 保持文字简短。 小图上的长句更难读,也更难检查。把小字移到单独一行,并给它单独的尺寸描述。
- 按格式固定尺寸。 为每种输出类型(海报、卡片、缩略图)保存一个尺寸,并对照 4,194,304 像素的分界线检查,让你展示给用户的价格与账单一致。
- 记录任务 ID、设置和
credits_amount。 当某个结果需要修正时,你可以重新运行相同的请求体,或把输出发送去编辑,而不必猜测它是怎么生成的。 - 用
n出草稿,用一张出成品。 一批very_low草稿的费用低于一张high2K 图像,只有选中的版式才进入最终渲染。
扩大使用某个提示词之前的检查清单
| 检查项 | 原因 |
|---|---|
| 每个图上字符串都放在引号中 | 文档对精确文字的规则 |
| 自定义尺寸为 32 的倍数,每边 256 到 4096 | 其他尺寸会被拒绝 |
very_low 只用于 4,194,304 像素或以下 | 更大的尺寸会拒绝它 |
edit_precision: high 和蒙版使用 size: auto | 其他尺寸会被拒绝 |
| 输出在 3 天内下载 | 生成的文件会过期 |
Ideogram 4.6 API 指南提供了一个能运行上述任意请求体的轮询循环,图上文字与精准编辑操作指南则更深入地讲解了提示词 8 到 10。
常见问题
Ideogram 4.6 API 的提示词可以多长? 1 到 10,000 个字符,且至少包含一个非空白字符。
如何在 Ideogram 4.6 API 的图像中得到精确文字? 在提示词中把每一行放进引号,并描述它的位置。检查输出;提示词扩展可能会添加一些小的额外细节。
一个 Ideogram 4.6 API 提示词能得到多个变体吗?
能,把 n 设为 1 到 8。每张图都按档位价格计费。
如何复现 Ideogram 4.6 API 的结果?
用相同的 seed 发送相同的请求体,seed 是 0 到 2,147,483,647 之间的整数。
Ideogram 4.6 API 的草稿应该用哪个质量?
very_low,每张 1.6 积分($0.008),适用于不超过 4,194,304 像素的尺寸。我们的测试草稿在 768×1024 下正确渲染了海报文字。