how-tos

Ideogram 4.6 API 提示词:用于海报、标签和编辑的 10 个请求体

Poyo.ai Team
5 min read
Share:

带请求体的 Ideogram 4.6 API 提示词

这是一套用于 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 草稿的费用低于一张 high 2K 图像,只有选中的版式才进入最终渲染。

扩大使用某个提示词之前的检查清单

检查项原因
每个图上字符串都放在引号中文档对精确文字的规则
自定义尺寸为 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 下正确渲染了海报文字。

Share: