Ideogram API：以排版为核心的 Ideogram V4 图像生成

大多数图像模型把文字当作一种纹理，运气好才渲染得出来。Ideogram V4 则把文字当作主体。如果你的需求涉及标题、logo 组合、海报或产品标签——任何要求文字必须真正可读的场景——那么在退而求其次、指望通用模型碰运气之前，先考虑它。

本页是 hiapi 上使用 ideogram-v4 的枢纽：它何时值得进入你的技术栈、API 允许与不允许你控制什么、两次真实渲染的精确提示词，以及下一步去哪里看完整代码演练。

何时应让排版决定模型选择

通用图像模型被训练成样样都行，这意味着文字渲染只是数百项技能之一——短词表现强，一旦需要完整标语或两行不同字号组成的 logo，就开始不稳。Ideogram 的模型以排版为核心训练目标，因此失败模式不同：与其说是字形错乱，更常见的是文字正确但位置与你要求略有偏差。

当交付物首先以可读性被评判时，选 ideogram-v4——海报、标识、包装样机、带真实 UI 文案的应用商店截图、logo 概念。当文字只是场景的附带元素（背景招牌、氛围细节），而照片真实感或场景复杂度比精确措辞更重要时，继续用通用模型。

动手实践：两次真实渲染

我们针对两种不同任务跑了同一套请求模式——一个带多层招牌文字的场景，以及一个带弧形文字的 logo 组合——来观察模型如何处理各自情况。

带两行霓虹文字的复古招牌

提示词（rendering_speed: QUALITY，aspect_ratio: 16:9）：

A retro 1970s American drive-in movie theater at dusk, tall neon marquee sign
reading "STARLIGHT DRIVE-IN" in glowing pink and cyan tube-light letters,
below it in smaller warm-yellow neon "TONIGHT: DOUBLE FEATURE", rows of
classic cars parked facing a giant outdoor screen in the distance, warm dusk
sky gradient from orange to deep purple, wide cinematic photograph, sharp
focus on the marquee lettering.

两行文字首次渲染就清晰可读且拼写正确——无需重试。我们拉动的主要杠杆是把精确文案放进双引号，并在紧邻位置描述字母风格（"glowing pink and cyan tube-light letters"），而不是泛泛地描述招牌、指望模型自行发明合理文案。

带弧形文字的圆形 logo

提示词（rendering_speed: BALANCED，aspect_ratio: 1:1）：

A minimalist coffee brand logo lockup on a flat cream background: a circular
badge emblem with the words "CEDAR & CO." in bold serif letters arcing
around the top of the circle, and "ROASTERS EST. 2024" in small sans-serif
letters arcing along the bottom, a simple line-art coffee bean icon centered
inside the circle, flat vector illustration style, single dark-brown ink
color, crisp clean linework.

这是更难的案例：两个不同字号的独立弧形文字元素沿圆环排列，外加一个必须保持居中且不与文字碰撞的图标。BALANCED 一次就正确处理了弧度和间距——这种能感知布局的文字摆放，正是那些把文字当装饰而非结构的模型常见的失败点。

你能（与不能）控制什么

ideogram-v4 的输入 schema 刻意很窄——只有四个字段，别无其他：

• prompt（必填）——你的完整描述，把要渲染的字面文字放进引号。
• rendering_speed（必填）——TURBO、BALANCED 或 QUALITY。这是主要的质量/成本/延迟旋钮。
• aspect_ratio（可选）——1:1、16:9、4:3、9:16 或 3:4。
• seed（可选）——整数，用于复现结果。

没有 negative_prompt，没有 style_type，没有 num_images，也没有图像编辑输入——该模型仅支持文生图。如果你习惯用负面提示词或风格预设来引导生成，这种控制必须移到主 prompt 中：正面描述你想要的（"flat vector illustration, single ink color"），而不是描述要避免的。

对我们行之有效的实际工作流：用 TURBO 迭代措辞和构图，因为这是查看文字是否摆对最便宜、最快的方式；然后用相同的 seed 在 QUALITY 上重跑胜出的提示词，产出最终素材。

价格一览

ideogram-v4 按渲染档位计价——TURBO 最便宜，QUALITY 是三者中最贵的，大致与它们之间的延迟差异相符。当前确切费率及其他模型定价见定价页；为批量任务做预算前先去那里确认，因为费率可能变动。

常见问题

ideogram-v4 支持图像编辑或图生图吗？ 不支持——该模型仅支持文生图。其 schema 中没有输入图像字段，因此这个特定模型不做现有图像的编辑或重绘风格。

我可以关闭文字渲染、只得到普通场景吗？ 可以，只要提示词中不放任何带引号的文字即可。模型不会强行把文字塞进构图——它渲染你所描述的内容。

迭代文字密集设计最快的方式是什么？ 用便宜的 TURBO 跑几轮，敲定措辞和布局，满意后切换到 QUALITY 并固定 seed，让最终渲染匹配你已批准的构图。

支持哪些宽高比？ 1:1、16:9、4:3、9:16 和 3:4。没有自由宽高——为你的投放位置选最接近的支持比例。

有没有办法修正某个渲染错误的单词？ 没有局部编辑参数——由于模型仅支持文生图，需要重跑提示词（可选换新 seed，或重写有问题的短语）。完整 API 请求示例（含错误处理）见分步 API 教程。

要点总结

• 当清晰可读、拼写正确的文字是交付物而非背景细节时——海报、logo、标识、标签——选 ideogram-v4。
• 在提示词中给精确文案加引号，并在紧邻位置描述其字母风格；由于没有专门的文字参数，这是实现准确排版的主要杠杆。
• 没有负面提示词或风格预设——完全通过 prompt 中正面、具体的描述来引导模型。
• 在 TURBO 上低成本迭代，在 QUALITY 上用固定 seed 定稿，锁定你已批准的构图。
• schema 严格（仅 4 个字段）且仅支持文生图——无编辑、无 resolution、无 num_images。

准备好试试了吗？前往 ideogram-v4 模型页在 playground 中测试提示词，或如果你要接入流水线，直接跳到curl 与 Python 演练。如果你的提示词在送入模型前需要更丰富的描述细节，提示词扩展也值得与排版密集型请求搭配使用。