Руководство по использованию
Рецепты промптов Ideogram v4.5: готовые к копированию типографические промпты и реальные результаты
Большинство моделей генерации изображений рисуют красивые постеры, но допускают ошибки в заголовках. Вся репутация Ideogram строится на обратном: она умеет правильно писать буквы. ideogram-v4.5/text-to-image — новейшая модель Ideogram для генерации изображений по тексту на hiapi, и, как все остальные модели, она работает через единый task API. Эта страница — библиотека промптов, которую можно использовать сразу: шесть рецептов, охватывающих логотипы, постеры, баннеры и упаковку, каждый с промптом, который я реально отправлял, и изображением, которое он реально вернул. Каждый результат ниже сгенерирован на ideogram-v4.5/text-to-image на hiapi; ни один не является стоковым материалом и ни один не проходил ретушь.
Она также отвечает на вопрос, который эти рецепты постоянно вызывают: уровень quality. v4.5 тарифицируется по трём уровням — low, medium и high — с большой разницей в цене, поэтому я прогнал один и тот же промпт с одним и тем же seed через все три уровня и сравнил фактический рендеринг текста. Результат отличается от того, что вы ожидаете; подробности в разделе о уровнях качества ниже.
Область: это базовый эндпоинт генерации изображений по тексту. У v4.5 также есть отдельный маршрут генерации изображений по изображению/редактирования (
ideogram-v4.5/image-to-image) с поддержкой масок и референсных изображений — это другая схема и другая статья.
Схема, которую v4.5 реально принимает (меньше, чем вы думаете)
Прежде чем перейти к рецептам, поговорим о входных данных — потому что интерфейс v4.5 не совпадает с интерфейсом ideogram-v4. Я исследовал онлайн-API поле за полем. Всё необходимое сводится к пяти полям:
| Поле | Тип | Описание |
|---|---|---|
prompt |
string, обязательно | Заключайте текст, который нужно отрисовать, в двойные кавычки (см. следующий раздел). |
quality |
low / medium / high |
Ценовой уровень. Поведение по умолчанию эквивалентно medium. |
num_images |
целое 1–8 | Одна задача может вернуть целый набор изображений. |
seed |
целое | Зафиксируйте его для честного сравнения двух промптов (или двух уровней). |
image_size |
перечисление | Одно из значений: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. |
Что меня удивило: полей aspect_ratio и resolution нет. v4 принимает строку aspect_ratio и rendering_speed; v4.5 убрал и то, и другое. Вы выбираете форму только из шести пресетов image_size, и это единственный контроль размера — API直接 отклоняет aspect_ratio, resolution, rendering_speed, magic_prompt, style_type и negative_prompt с ошибкой additional properties not allowed. Так что если вы мигрируете с запросов v4, удалите эти поля, иначе каждый вызов будет возвращать 400.
Цены взяты с онлайн-страницы тарифов hiapi, оплата за изображение, зависит от уровня:
quality |
Цена за изображение |
|---|---|
low |
$0.043 |
medium |
$0.086 |
high |
$0.3145 |
Ниже минимальный запрос — создайте задачу, затем опрашивайте до завершения:
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": "A clean wordmark logo, the text \"NORTHWIND ROASTERS\" in an elegant high-contrast serif, cream background, centered",
"quality": "medium",
"image_size": "square",
"num_images": 1
}
}'
# -> {"data":{"taskId":"tk-..."}}
import os, time, requests
BASE = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
task = requests.post(BASE, headers=H, json={
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": 'A clean wordmark logo, the text "NORTHWIND ROASTERS" '
'in an elegant high-contrast serif, cream background, centered',
"quality": "medium",
"image_size": "square",
"num_images": 1,
},
}).json()
tid = task["data"]["taskId"]
while True: # poll to a terminal state
d = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
if d["status"] in ("success", "fail"):
break
time.sleep(5)
print(d["output"][0]["url"]) # temp URL — download it right away
output[0].url — это временная ссылка, которая истекает примерно через неделю, поэтому скачивайте байты сразу — не используйте её как hotlink в продакшене.
Единственное правило, определяющее успех каждого рецепта
Всё ниже строится на одной привычке: заключайте точный текст, который нужно отрисовать, в двойные кавычки и не оставляйте важные формулировки на усмотрение модели.
Ideogram расширяет ваш промпт. Если попросить постер музыкального фестиваля, он с радостью добавит состав исполнителей, даты и цены на билеты, которых вы никогда не писали — это хорошо для реальных макетов, но рискованно, если эти детали должны быть правильными. В тестах каждая короткая строка, которую я заключал в кавычки, была написана идеально; опечатки появляются там, где модель придумывает текст сама. Поэтому: заключайте в кавычки названия брендов, заголовки, текст кнопок, даты. Декоративные заполнители оставляйте модели только тогда, когда вам неважно, что она скажет.
Усвоив это правило, перейдём к рецептам.
Рецепт 1 — текстовый логотип
A clean minimalist wordmark logo for a specialty coffee brand, the text "NORTHWIND ROASTERS" set in an elegant high-contrast serif, a small compass-rose icon integrated above the letter N, warm cream background, centered, flat vector-style design, generous negative space
image_size: square · quality: medium

«NORTHWIND ROASTERS» написано абсолютно правильно, антиква действительно элегантна, а негативное пространство выглядит как настоящий логотип бренда. Два честных замечания: модель разместила розу ветров по центру над всей надписью, а не «над буквой N» — v4.5 воспринимает пространственные указания как рекомендации, а не как координаты — и она по своей инициативе добавила слоган, который я не заказывал: «SPECIALTY COFFEE · EST. 2019». Это расширение — именно то поведение, о котором говорит правило выше: здесь оно удобно, но если ваш реальный слоган отличается, явно напишите его в кавычках, а не позволяйте модели угадывать.
Рецепт 2 — постер мероприятия
A vertical concert poster for an indie music festival, large headline text "ECHO VALLEY FEST" across the top, below it two lines reading "AUGUST 14-16" and "RIVERSIDE PARK", retro 1970s psychedelic palette of orange, magenta and teal, layered sunburst background, bold condensed type, high detail
image_size: portrait_4_3 · quality: medium

Все три строки в кавычках — «ECHO VALLEY FEST», «AUGUST 14-16», «RIVERSIDE PARK» — отрисованы чисто, а форма portrait_4_3 даёт заголовку пространство для дыхания. Модель также сама вписала правдоподобный состав групп и подвал «GATES 6PM · ALL AGES · $45 ADV / $60 DOOR». Для макета предложения это подарок; для реального постера перепишите эти выдуманные строки обратно в промпт, чтобы контролировать их.
Рецепт 3 — баннер для соцсетей
A horizontal social media ad banner for a fitness app, left-aligned headline text "MOVE MORE." in heavy bold uppercase, a smaller line reading "Start your 7-day free trial", and a rounded call-to-action button with the text "GET THE APP", energetic gradient from lime green to deep blue, clean modern UI style
image_size: landscape_16_9 · quality: medium

Это лучшее проявление v4.5: три отдельные короткие строки — заголовок, подзаголовок и текст кнопки — размещены в разных UI-ролях, и все написаны правильно, включая точку в «MOVE MORE.». Пресет landscape_16_9 — то, что нужно, когда требуется широкий баннер или миниатюра. Короткий, явный, заключённый в кавычки текст — именно то, в чём сильна эта модель.
Рецепт 4 — этикетка упаковки продукта
A product label for a bottle of artisanal hot sauce, brand name "EMBER & ASH" in a vintage woodcut serif, product line "SMOKED HABANERO" below it, a small badge reading "SMALL BATCH - 150ML", kraft-paper texture background with charcoal and ember-orange ink, symmetrical layout
image_size: square_hd · quality: medium

Упаковка — самый сложный тест текста: мелкий шрифт, специальные символы, значки — и v4.5 справился с ключевыми частями. «EMBER & ASH» правильно отрисовала амперсанд (классическая точка отказа), «SMOKED HABANERO» чисто, а гравюрный перец хабанеро — незаказанная удачная находка. Маленький значок получился не совсем таким: я просил «SMALL BATCH - 150ML», а получил «SMALL BATCH · EST · 150ML» плюс строку «BOTTLED IN SMALL BATCHES». Урок из руководства остаётся в силе — чем мельче шрифт, тем больше модель импровизирует, поэтому для этикеток, идущих в печать, держите микротекст коротким и проверяйте каждый рендер.
Уровни качества на практике: low vs medium vs high
Все эти рецепты выполнялись на medium. Но v4.5 берёт $0.043 / $0.086 / $0.3145 за low / medium / high — разница до 7 раз — поэтому стоит понять, за что вы платите. Я прогнал намеренно текстонасыщенный промпт (плотный инфографический постер) через все три уровня, используя один и тот же seed, так что менялось только quality:
A dense informational poster titled "CITY TRANSIT GUIDE" with three labeled columns headed "BUS", "METRO" and "TRAM", a short line of body text under each heading, clean Swiss grid layout, red and black ink on off-white paper, flat vector infographic style
low — $0.043

Макет и крупный заголовок «CITY TRANSIT GUIDE» чёткие. Но модель придумала подзаголовок и ошиблась в нём — «WINTER SCHHEDULE» с лишней H — а также повторила значок маршрута (номер «41» встречается дважды). Заключённые в кавычки заголовки (BUS/METRO/TRAM) в порядке; именно безкавычечный текст, который она добавила, оказался проблемным.
medium — $0.086

Тот же seed, уровень выше, и подзаголовок исправился сам до «WINTER SCHEDULE». Три абзаца основного текста читаются чётко, навигация в подвале («TICKETS · ZONES · DELAYS · HELP») чистая. Есть небольшой сбой в пояснительном тексте («CENTRHL» вместо «CENTRAL»), но для такого текстонасыщенного макета это явно самый чистый из трёх.
high — $0.3145

Вот и контринтуитивная часть. high отрисовывает акцидентные шрифты — крупный заголовок, метки BUS/METRO/TRAM — острее всех трёх. Но плотные абзацы основного текста схлопываются в уверенный мусор («Mari routes runt monen downtwing...», «tith tixve stations across five...»). При цене в 3,6 раза выше medium он даёт на этом макете худший основной текст, а не лучший.
Вывод практический, а не принижающий модель: уровень quality повышает тщательность, с которой v4.5 отрисовывает выбранные шрифты, но он не делает модель лучше в придумывании длинных фрагментов текста, которых вы не писали — на high она просто выдумывает тщательнее и более неправильно. Итак:
- Используйте
mediumпо умолчанию. Для всего, где есть реальный текст, это оптимальный баланс, и он исправляет опечатки, которые вноситlow. - Оставьте
highдля работ с преимущественно крупными, заданными шрифтами — логотипов, постеров с однострочным заголовком — там его дополнительная острота оправдана, и нет абзацев, где он мог бы галлюцинировать. lowподходит для черновиков и миниатюр, где отдельные опечатки не важны.- Независимо от уровня, никогда не полагайтесь на модель в написании длинного основного текста. Заключайте в кавычки текст, который должен быть правильным; остальное считайте заполнителем.
FAQ
Можно ли задать 1080×1920 или точный размер в пикселях? Нет. v4.5 t2i принимает только шесть пресетов image_size — square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Нет полей ширины/высоты или aspect_ratio. Выберите ближайший пресет и обрежьте, если нужна точная пропорция.
Чем это отличается от ideogram-v4? Входные данные другие. v4 использует aspect_ratio плюс rendering_speed (turbo/balanced/quality); v4.5 заменил и то, и другое пресетами image_size и ценовыми уровнями quality. Если вам нужна форма запроса v4, она рассмотрена в руководстве по ideogram-v4, а если вы всё ещё выбираете модель для типографики, поможет ideogram-v4 vs Nano Banana 2.
Может ли она редактировать существующие изображения? На этом эндпоинте — нет. Генерация изображений по тексту — это ideogram-v4.5/text-to-image; редактирование (редактирование по промпту, маски, референсные изображения) — отдельный маршрут ideogram-v4.5/image-to-image.
Текст всегда правильный? Короткие строки в кавычках — названия брендов, заголовки, текст кнопок — надёжны в каждом рецепте этой статьи. А вот длинный текст, который модель придумывает сама, — нет; вычитывайте каждый рендер, особенно мелкие значки и пояснительный текст.
Как быстро генерировать варианты? Установите num_images до 8 в одной задаче, чтобы вернуть набор сразу, или зафиксируйте seed и поменяйте одно слово, чтобы сравнить промпты в одинаковых условиях.
Запустите их сами
Каждый промпт выше можно скопировать и вставить — замените строки в кавычках своими названиями брендов, заголовками или датами и отправьте. Получите актуальную схему на странице модели ideogram-v4.5/text-to-image, откройте страницу тарифов, чтобы выбрать уровень quality, а если это ваш первый вызов task API, быстрый старт проведёт вас через получение ключа и опрос первой задачи. Заключайте текст в кавычки, используйте medium по умолчанию и вычитывайте каждый рендер перед запуском.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по началу работы с seedream-5.0-pro/image-to-image: возможности, цены и ключевые моменты интеграции
Границы возможностей модели редактирования изображений ByteDance, принципы тарификации и практика инженерной интеграции
-
Руководство по использованию
Руководство по использованию seedream-5.0-pro text-to-image: границы возможностей, интеграция API и контроль затрат
Практический взгляд для разработчиков: от ключевых параметров до оценки стоимости $0.05 за изображение
-
Руководство по использованию
Руководство по началу работы с Hailuo 2.3 Fast для генерации видео из изображений: границы возможностей, цены и практика интеграции
Ключевые моменты выбора и интеграции модели MiniMax для генерации видео из изображений для разработчиков