
Ideogram 4.6 API создан для сценария, с которым большинство API изображений справляются плохо: сгенерировать постер с точными словами, а затем изменить одну строку этого текста, не перерисовывая остальное. В этом руководстве обе части разобраны с телами запросов: текст на изображении с ideogram-v4.6, а также правки высокой точности, по маске и локальные правки с ideogram-v4.6-edit. Всё здесь выполняется на модели Ideogram 4.6 в PoYo, а цифры взяты из нашего теста в день запуска 20 ноября 2026 года.
Часть 1: точный текст на изображении с Ideogram 4.6 API
Документация PoYo даёт одно правило для текста: заключайте точный текст для изображения в кавычки в промпте. Опишите, где располагается каждая строка и какого она размера, так же, как вы ставили бы задачу дизайнеру.
Вот запрос из нашего теста в день запуска (задача M4WA9OIQXVV80DHG):
{
"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
}
}
Он вернул один PNG 2304×3072 размером около 10.8 MB, и было списано 40 credits ($0.20) — ставка 4K high. Все три строки в кавычках отрисованы так, как написаны, включая мелкую строку курсивом. Тот же промпт с quality: very_low и size: 3:4 (задача BS7M64COKT80JSLX) вернул черновик 768×1024 за 1.6 credits ($0.008), тоже с правильным текстом, но с другой композицией.
Три привычки делают запросы с текстом надёжнее в production:
| Привычка | Зачем |
|---|---|
| Одна строка в кавычках на каждую строку текста | Каждая строка — отдельная единица, которую можно проверить и позже отредактировать |
| Указывайте размер и положение каждой строки («крупный заголовок вверху», «строка поменьше ниже») | Иерархия становится частью запроса, а не делом случая |
| Проверяйте результат перед публикацией | Сама Ideogram советует: «Проверяйте орфографию и расположение в итоговом результате». |
Расширение промпта в этом API всегда включено, поэтому модель может добавить детали, о которых вы не просили. На нашем постере она добавила маленькую надпись «EST. 1987» и веб-адрес в нижних углах. Если макет должен содержать только ваши слова, укажите это в промпте и проверьте результат или удалите лишнее правкой.
Часть 2: три способа редактирования с ideogram-v4.6-edit
Каждая правка принимает ровно одно исходное изображение в image_urls и prompt. Настройки ниже определяют, какую часть изображения модель может затронуть. Если ваше приложение позволяет пользователям загружать исходник, предварительная проверка избавит от неудачных задач; один из способов показан в руководстве по модерации изображений.
| Режим | Настройки | Что сохраняется | Размер результата |
|---|---|---|---|
| Обычная правка | edit_precision: regular (по умолчанию) | Изображение заново генерируется по промпту | auto или любой пресетный/пользовательский размер без маски |
| Правка высокой точности | edit_precision: high, context_window: none | Неизменённые пиксели восстанавливаются | Разрешение исходника |
| Локальная правка | edit_precision: high, context_window: auto, mask_url | Каждый пиксель за пределами области вокруг маски | Разрешение исходника |
Ideogram утверждает, что 4.6 «оставляет гораздо меньше дрейфа пикселей за пределами ваших правок», и на своей странице модели сообщает 90% для правок по маске («изменить только закрашенную область») против 82% у Ideogram 4.5. Это оценки Ideogram. Вот что измерили мы.
Правка высокой точности: изменить одну строку текста
{
"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
}
}
В нашем тесте (задача 672JRU198S22NS8D) исходником был постер 2304×3072 из Части 1. Результат — 2304×3072 с новой строкой даты. Попиксельное сравнение с оригиналом поместило все изменённые пиксели в один прямоугольник, от (471, 2699) до (1826, 2756): строка с датой, около 1.1% изображения. Заголовок, иллюстрация и мелкая строка курсивом не изменились. Списано 120 credits ($0.60), потому что правка высокой точности сохраняет разрешение исходника, а 2304×3072 больше 4,194,304 пикселей.
Два правила, которые стоит запомнить: edit_precision: high требует size: auto (или отсутствия size) и отклоняет background.
Правка по маске: ограничьте изменение одной областью
Маска убирает догадки о том, где будет правка. Она должна иметь те же размеры, что и исходник, быть чёрной там, где модель может редактировать, белой там, где нужно сохранить, и содержать обе области. Этот фрагмент на Python строит маску по прямоугольнику:
from PIL import Image, ImageDraw
source = Image.open("poster.png")
mask = Image.new("L", source.size, 255) # white = keep
ImageDraw.Draw(mask).rectangle((440, 2660, 1860, 2800), fill=0) # black = edit
mask.save("date-line-mask.png")
Загрузите маску (публичный URL или base64 data URI) и добавьте её в запрос:
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change the sign text to \"OPEN LATE\"",
"image_urls": [
"https://example.com/storefront.png"
],
"mask_url": "https://example.com/sign-mask.png",
"edit_precision": "high",
"context_window": "auto",
"quality": "high"
}
}
С context_window: auto редактируется только область вокруг маски, а разрешение исходника сохраняется. Слишком большая маска приводит к откату на редактирование всего изображения. context_window: auto без mask_url и edit_precision: high отклоняется, а маска всегда требует size: auto. С маской можно добавить до 3 референсных изображений в reference_image_urls, например логотип или образец шрифта.
Часть 3: проверьте правку в своём пайплайне
Если ваше приложение обещает «изменился только текст», проверяйте это. Это та же проверка, которую мы провели для правки в день запуска:
from PIL import Image, ImageChops
before = Image.open("before.png").convert("RGB")
after = Image.open("after.png").convert("RGB")
assert before.size == after.size, "high-precision edits keep the source size"
diff = ImageChops.difference(before, after).convert("L").point(lambda v: 255 if v > 32 else 0)
box = diff.getbbox()
print("changed box:", box)
if box:
area = (box[2] - box[0]) * (box[3] - box[1])
print(f"box covers {area / (before.width * before.height):.2%} of the image")
Сравните прямоугольник с областью, которую вы собирались изменить, например с маской. Если он выходит далеко за её пределы, повторите запрос с маской и context_window: auto или с более точным промптом.
Часть 4: многошаговые правки и стоимость
Для серии изменений отправляйте каждый результат обратно как следующий исходник в image_urls и меняйте одну вещь за запрос. На странице Ideogram сказано, что 4.6 создана, чтобы «продолжать дорабатывать одно и то же изображение за несколько шагов». Каждый шаг — отдельная задача, тарифицируемая по размеру результата:
| Правка исходника... | medium | high |
|---|---|---|
| До 4,194,304 пикселей | 12 credits ($0.06) | 44 credits ($0.22) |
| Больше 4,194,304 пикселей | 40 credits ($0.20) | 120 credits ($0.60) |
Три изменения текста при high на нашем постере 4K обошлись бы в 360 credits ($1.80); на версии того же постера 1728×2304 — в 132 credits ($0.66). Скачивайте каждый результат: сгенерированные файлы хранятся 3 дня. Больше бюджетов — в статье о ценах, а в руководстве по API есть цикл опроса, который можно переиспользовать на каждом шаге.
Часто задаваемые вопросы
Как разместить точный текст на изображении с Ideogram 4.6 API?
Заключите каждую строку в кавычки в prompt запроса к ideogram-v4.6 и опишите её размер и положение. Проверьте результат перед публикацией.
Как изменить текст на готовом изображении с Ideogram 4.6 API?
Отправьте изображение в ideogram-v4.6-edit с промптом вроде: Change only the date line to "NEW TEXT". Keep everything else exactly the same. Установите edit_precision: high и size: auto.
Чем отличаются значения regular и high у edit_precision?
regular заново генерирует изображение по промпту и допускает новый размер и background. high выполняет точную правку, восстанавливает неизменённые пиксели и сохраняет разрешение исходника.
Влияет ли маска на цену Ideogram 4.6 API? Нет. Правки тарифицируются за выходное изображение по уровню качества и размера. Маска и до 3 референсов включены.
Почему небольшая правка текста стоила 120 credits?
Правка высокой точности качества high для исходника больше 4,194,304 пикселей идёт по ставке правки 4K high. Редактируйте исходник меньшего размера или используйте medium (40 credits в 4K, 12 в 2K).
Полный список параметров — в справочнике Ideogram 4.6 Edit API. Набор проверенных шаблонов промптов — в руководстве по промптам Ideogram 4.6 API.