
Ideogram 4.6 API даёт доступ к новейшей модели изображений Ideogram через один REST-эндпоинт в PoYo: ideogram-v4.6 для генерации по тексту и ideogram-v4.6-edit для редактирования одного исходного изображения с необязательной маской и референсными изображениями. Результат — до 4096 пикселей по стороне, цены начинаются от 1.6 credits ($0.008) за изображение, и каждый запрос использует тот же API-ключ, что и остальной PoYo. На этой странице: что такое Ideogram 4.6, точные лимиты, ценовые уровни и что мы измерили в день запуска.
Что такое Ideogram 4.6?
Ideogram 4.6 — модель генерации и редактирования изображений от Ideogram, выпущенная 19 ноября 2026 года. Ideogram называет её «нашей самой точной моделью редактирования» и утверждает, что она «генерирует изображения в нативном 4K» — «без апскейла». На своей странице модели Ideogram также пишет, что модель «оставляет гораздо меньше дрейфа пикселей за пределами ваших правок и точнее сохраняет цвет».
Ideogram подкрепляет это оценками по задачам при высоком качестве, сравнивая 4.6 с 4.5:
| Задача (в описании Ideogram) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Точный цвет: перекрасить объект в фирменный hex-код | 83% | 46% |
| Детали продукта: исправить мелкий дефект на фото продукта | 86% | 61% |
| Продуктовые снимки: постановка, рестайлинг и смена этикеток | 88% | 66% |
| Согласованность персонажа: человек остаётся узнаваемым в новой сцене | 85% | 69% |
| Правки по маске: изменить только закрашенную область | 90% | 82% |
Это цифры Ideogram, а не измерения PoYo. Для интеграции через API они указывают на три типа запросов, которые стоит отправлять сюда:
- Постеры, этикетки и графика для соцсетей с точными словами: поместите текст в кавычки в промпте.
- Правки, которые не должны затрагивать всё остальное: новая дата на флаере, перекрашенный продукт, одна изменённая деталь.
- Крупная печать: пользовательские размеры до 4096 пикселей по стороне без отдельного шага апскейла.
Ideogram 4.6 API вкратце
| Генерация по тексту | Редактирование | |
|---|---|---|
| ID модели в PoYo | ideogram-v4.6 | ideogram-v4.6-edit |
| Эндпоинт отправки | POST https://api.poyo.ai/api/generate/submit | Тот же |
| Результат | Опрос GET /api/generate/status/{task_id} или callback_url | Так же |
| Входные данные | prompt | prompt + ровно одно изображение в image_urls, необязательные mask_url и reference_image_urls |
| Изображений за запрос | от 1 до 8 (n) | от 1 до 8 (n) |
| Уровни качества | very_low, low, medium (по умолчанию), high | Те же |
| Релиз Ideogram | 19 ноября 2026 | 19 ноября 2026 |
| Документация | Справочник Ideogram V4.6 API | Справочник Ideogram V4.6 Edit |
Оба ID используют общую авторизацию, опрос и биллинг, поэтому приложение может генерировать одной моделью и дорабатывать другой без второй интеграции.
Лимиты и поля запроса
| Поле | Правило в PoYo |
|---|---|
prompt | Обязательно, от 1 до 10,000 символов, должно содержать текст помимо пробелов. Точный текст для изображения заключайте в кавычки. |
size | auto (по умолчанию), 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 |
quality | very_low, low, medium (по умолчанию), high; very_low только до 4,194,304 пикселей |
n | Целое число от 1 до 8 |
background | transparent или opaque; только для генерации по тексту и обычных правок |
seed | Целое число от 0 до 2,147,483,647 |
image_urls (edit) | Ровно одно исходное изображение, публичный HTTP(S) URL или base64 data URI, всегда массив |
mask_url (edit) | Те же размеры, что у исходника; чёрное редактируется, белое сохраняется; требует size: auto |
reference_image_urls (edit) | От 0 до 4 изображений или не более 3 с маской |
edit_precision (edit) | regular (по умолчанию) или high; high требует size: auto и отклоняет background |
context_window (edit) | 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 credit = $0.005.
| Качество | Генерация 2K | Генерация 4K | Правка 2K | Правка 4K |
|---|---|---|---|---|
very_low | 1.6 credits ($0.008) | недоступно | 1.6 credits ($0.008) | недоступно |
low | 6 credits ($0.03) | 12 credits ($0.06) | 6 credits ($0.03) | 12 credits ($0.06) |
medium | 12 credits ($0.06) | 24 credits ($0.12) | 12 credits ($0.06) | 40 credits ($0.20) |
high | 20 credits ($0.10) | 40 credits ($0.20) | 44 credits ($0.22) | 120 credits ($0.60) |
size: auto и шесть пресетов при генерации по тексту всегда относятся к 2K. При правках с size: auto результат сохраняет геометрию исходника, поэтому крупный исходник попадает в уровень 4K. Эти цены совпадают с таблицей цен за изображение на странице модели Ideogram; в разборе цен посчитаны реальные варианты запросов.
Что мы измерили в день запуска
Команда PoYo выполнила эти запросы в production API PoYo 20 ноября 2026 года. Промпт описывал постер в технике шелкографии «NORTHBOUND JAZZ FESTIVAL» со строками «JUNE 12-14 · RIVERSIDE PARK» и «Three nights. Twenty-one bands. Free entry before 6 PM.»
| Задача | Запрос | Результат | Списано |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | Один PNG 2304×3072, около 10.8 MB | 40 credits ($0.20) |
BS7M64COKT80JSLX | Тот же промпт, quality: very_low, size: 3:4 | PNG 768×1024 | 1.6 credits ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit по первому постеру, edit_precision: high, context_window: none, size: auto, quality: high | PNG 2304×3072 | 120 credits ($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 credits ($0.40). Ответ содержит data.task_id со статусом not_started. Опрашивайте эндпоинт статуса, пока он не станет finished, и берите изображения из data.files, либо передайте callback_url на верхнем уровне. Всегда проверяйте code в теле ответа: некоторые ошибки валидации возвращают HTTP 200 с code: 400. В руководстве по API есть ограниченный по времени цикл опроса на Python и тело запроса для каждого режима ввода.
Где доступен Ideogram 4.6
Ideogram предлагает 4.6 в собственном приложении и API с двумя эндпоинтами: Generate и Precise Edit. В PoYo вы вызываете модель тем же ключом, что и все остальные модели, через тот же поток задач и callback, а на странице модели есть 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 перечислены изменения полей, новые правила размеров и цена одного и того же запроса. Если вы сравниваете другие API изображений в PoYo, см. обзор MAI Image 2.7 API и сравнение Kling Image 4.0, GPT Image 2.6 и Seedream 5.5.
Часто задаваемые вопросы
Какой ID модели у Ideogram 4.6 API?
Используйте ideogram-v4.6 для генерации по тексту и ideogram-v4.6-edit для редактирования. ideogram-4-6 — это только slug страницы в PoYo, а не ID модели.
Сколько стоит Ideogram 4.6 API?
От 1.6 credits ($0.008) за изображение при very_low 2K. Изображение medium 2K по умолчанию стоит 12 credits ($0.06), high — 20 credits ($0.10) в 2K и 40 credits ($0.20) в 4K. Правки 4K высокого качества стоят 120 credits ($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} или получите callback.