guides

Ideogram 4.6 API:Ideogram 4.6 是什么、价格、限制与 4K 编辑

Poyo.ai Team
5 min read
Share:

PoYo 上的 Ideogram 4.6 API

通过 Ideogram 4.6 API,你可以在 PoYo 上用一个 REST 接口调用 Ideogram 最新的图像模型:ideogram-v4.6 用于文生图,ideogram-v4.6-edit 用于编辑一张源图,可选蒙版和参考图。输出每边最高 4096 像素,价格从每张 1.6 积分($0.008)起,所有请求都使用与 PoYo 其他模型相同的 API key。本文介绍 Ideogram 4.6 是什么、确切的限制、价格档位,以及我们在发布当天的实测结果。

Ideogram 4.6 是什么?

Ideogram 4.6 是 Ideogram 推出的图像生成与编辑模型,于 2026 年 11 月 19 日发布。Ideogram 称它是 "our most precise editing model yet",并表示它 "generates images in native 4K","no upscaling"。在其模型页面上,Ideogram 还表示该模型 "leaves far less pixel drift outside your edits and holds color more accurately"。

Ideogram 用高质量档下的任务得分来支撑这些说法,对比了 4.6 与 4.5:

任务(Ideogram 的描述)Ideogram 4.6Ideogram 4.5
精确颜色:把物体改成品牌十六进制色值83%46%
产品细节:修复产品照片中的小瑕疵86%61%
产品图:产品布景、改换风格与更换标签88%66%
角色一致性:在新场景中保持人物可辨认85%69%
蒙版编辑:只修改涂抹的区域90%82%

这些是 Ideogram 的数据,不是 PoYo 的测量结果。对 API 集成来说,它们指向三类值得发到这里的请求:

  • 带精确文字的海报、标签和社交图片:在提示词中把文字放进引号。
  • 必须保持其余部分不变的编辑:传单上的新日期、改色的产品、某一处改动的细节。
  • 大尺寸印刷:自定义尺寸每边最高 4096 像素,无需单独的放大步骤。

Ideogram 4.6 API 一览

文生图编辑
PoYo 模型 IDideogram-v4.6ideogram-v4.6-edit
提交接口POST https://api.poyo.ai/api/generate/submit相同
结果轮询 GET /api/generate/status/{task_id} 或使用 callback_url相同
输入promptprompt + image_urls 中恰好一张图,可选 mask_url 和 reference_image_urls
每次请求的图像数1 到 8(n)1 到 8(n)
质量档位very_low、low、medium(默认)、high相同
Ideogram 发布日期2026 年 11 月 19 日2026 年 11 月 19 日
文档Ideogram V4.6 API 参考Ideogram V4.6 Edit 参考

两个 ID 共用鉴权、轮询和计费,因此应用可以用一个生成、用另一个精修,无需第二套集成。

限制与请求字段

字段PoYo 上的规则
prompt必填,1 到 10,000 个字符,必须包含非空白文字。图上的精确文字放进引号。
sizeauto(默认)、1:1(512×512)、1:1 HD(1024×1024)、4:3、3:4、16:9、9:16,或自定义 WIDTHxHEIGHT
自定义尺寸小写 x,两边均为 256 到 4096 像素且为 32 的倍数,宽高比在 1:6 到 6:1 之间
qualityvery_low、low、medium(默认)、high;very_low 仅限不超过 4,194,304 像素
n整数 1 到 8
backgroundtransparent 或 opaque;仅限文生图和普通编辑
seed整数 0 到 2,147,483,647
image_urls(编辑)恰好一张源图,公开的 HTTP(S) URL 或 base64 data URI,始终为数组
mask_url(编辑)尺寸与源图相同;黑色区域被编辑,白色区域保留;需要 size: auto
reference_image_urls(编辑)0 到 4 张,带蒙版时最多 3 张
edit_precision(编辑)regular(默认)或 high;high 需要 size: auto,且不接受 background
context_window(编辑)none(默认)或 auto;auto 需要 mask_url 和 edit_precision: high

input 中的任何其他字段都会被拒绝,并返回 unsupported fields 错误。生成的文件保留 3 天,请复制到你自己的存储。

Ideogram 4.6 API 价格

PoYo 按输出图像计费,依据质量和尺寸档位。"2K" 指输出不超过 4,194,304 像素(面积相当于 2048×2048);更大的即为 "4K"。1 积分 = $0.005。

质量文生图 2K文生图 4K编辑 2K编辑 4K
very_low1.6 积分($0.008)不可用1.6 积分($0.008)不可用
low6 积分($0.03)12 积分($0.06)6 积分($0.03)12 积分($0.06)
medium12 积分($0.06)24 积分($0.12)12 积分($0.06)40 积分($0.20)
high20 积分($0.10)40 积分($0.20)44 积分($0.22)120 积分($0.60)

对文生图来说,size: auto 和六个预设尺寸始终是 2K。对于 size: auto 的编辑,输出保持源图的几何尺寸,因此大尺寸源图会落入 4K 档。这些价格与 Ideogram 模型页面上的单张价格表一致;价格详解用真实的请求形态逐一计算。

发布当天的实测

PoYo 团队于 2026 年 11 月 20 日在 PoYo 生产 API 上运行了这些任务。提示词是一张丝网印刷风格的 "NORTHBOUND JAZZ FESTIVAL" 海报,包含 "JUNE 12-14 · RIVERSIDE PARK" 和 "Three nights. Twenty-one bands. Free entry before 6 PM." 两行文字。

任务请求输出扣费
M4WA9OIQXVV80DHGideogram-v4.6、quality: high、size: 2304x3072、n: 1一张 2304×3072 PNG,约 10.8 MB40 积分($0.20)
BS7M64COKT80JSLX相同提示词,quality: very_low、size: 3:4768×1024 PNG1.6 积分($0.008)
672JRU198S22NS8D对第一张海报使用 ideogram-v4.6-edit,edit_precision: high、context_window: none、size: auto、quality: high2304×3072 PNG120 积分($0.60)

前两张海报中的所有文字都按原文呈现,包括那行小号斜体字;草稿的构图则不同。编辑提示词是:Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. 与原图逐像素对比后,所有变化的像素都落在一个框内,即 (471, 2699) 到 (1826, 2756),约占图像的 1.1%;其余部分没有变化。这次编辑按 4K high 档计费,因为高精度编辑会保持源图分辨率。图上文字与精准编辑指南详细讲解了这个请求。

你的第一个 Ideogram 4.6 API 请求

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v4.6",
    "input": {
      "prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
      "size": "2048x3072",
      "quality": "high",
      "n": 2
    }
  }'

2048x3072 是 6,291,456 像素,因此该请求按 4K high 费率计费:2 × 40 = 80 积分($0.40)。响应中包含 data.task_id,状态为 not_started。轮询状态接口直到状态为 finished,再从 data.files 读取图像,或者传入顶层的 callback_url。务必检查响应体中的 code:部分校验错误会返回 HTTP 200 加 code: 400。API 指南提供了有超时上限的 Python 轮询循环,以及每种输入模式的请求体。

在哪里可以使用 Ideogram 4.6

Ideogram 在自己的应用和 API 中提供 4.6,有两个接口:Generate 和 Precise Edit。在 PoYo 上,你用调用其他所有模型的同一个 key 来调用它,使用相同的任务与回调流程,并且模型页面上的 Playground 会在每次运行前显示价格。在 PoYo 上,参考图通过 ideogram-v4.6-edit 传入;文生图 ID 只接受提示词,加上 size、quality、n、background 和 seed 这些控制项。

请求该路由到哪里

请求模型 ID 与设置
草稿和版式探索ideogram-v4.6,very_low 或 low,预设尺寸,n 最多 8
面积不超过 2048×2048 的最终海报和社交图片ideogram-v4.6,high,自定义尺寸如 1728x2304
印刷和大幅面作品ideogram-v4.6,low 到 high,超过 4,194,304 像素的自定义尺寸
改动一处细节、其余保持不变ideogram-v4.6-edit,edit_precision: high
重绘大图中的某个区域ideogram-v4.6-edit,mask_url,edit_precision: high,context_window: auto
参照参考图改换风格,并使用新的输出尺寸ideogram-v4.6-edit,edit_precision: regular,reference_image_urls,自定义 size

从 Ideogram 4.5 迁移过来?4.6 与 4.5 对比列出了字段变化、新的尺寸规则以及相同请求的价格。如果你在 PoYo 上权衡其他图像 API,请参阅 MAI Image 2.7 API 概览和 Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5 对比。

常见问题

Ideogram 4.6 API 的模型 ID 是什么? 文生图用 ideogram-v4.6,编辑用 ideogram-v4.6-edit。ideogram-4-6 只是 PoYo 的页面 slug,不是模型 ID。

Ideogram 4.6 API 多少钱? very_low 2K 每张 1.6 积分($0.008)起。默认的 medium 2K 图像为 12 积分($0.06),high 在 2K 下为 20 积分($0.10),在 4K 下为 40 积分($0.20)。高质量 4K 编辑为 120 积分($0.60)。

Ideogram 4.6 API 能返回的最大图像是多少? 自定义尺寸每边最高 4096 像素,须为 32 的倍数,宽高比在 1:6 到 6:1 之间。超过 4,194,304 像素的按 4K 档计费。

Ideogram 4.6 API 能在图像上渲染文字吗? 能,把精确的文字放进提示词的引号中。在我们发布当天的测试中,一张 2304×3072 的海报按原文渲染了标题、日期行和一行小号斜体字。Ideogram 仍建议在最终结果中检查拼写和位置。

Ideogram 4.6 API 能返回透明背景图像吗? 能。文生图或普通编辑时把 background 设为 transparent。高精度编辑不接受 background。

Ideogram 4.6 API 兼容 OpenAI SDK 吗? 不兼容。它是异步任务 API:提交到 /api/generate/submit,然后轮询 /api/generate/status/{task_id} 或接收回调。

Share: