Введение
Передайте композицию в prompt, включив нужные слова в кавычках. Выберите качество отдельно от размера и пропорций; расширение промпта может дополнить краткое задание.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Издатель | Ideogram |
| Поддерживаемые сценарии | Генерация по тексту; редактирование изображений |
| Объём промпта | До 10 000 символов; нужные надписи в кавычках |
| Качество генерации | low, medium (исходно), high |
| Качество правок |
|
| Разрешение кадра | 1k или 2k; размер не меняет тариф качества |
| Пропорции изображения | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
| Направление правки | Необязательная чёрно-белая маска; белым — изменяемая область |
| Число референсов | До четырёх изображений стиля или содержания; до трёх с маской |
| Точность изменения | regular или high; high делает правку сдержаннее |
| Расчёт цены | За картинку по quality; размер, пропорции и число референсов цену не меняют; ошибки бесплатны |
| Хранение созданного | Сгенерированные файлы удаляются через 14 дней |
Ключевые возможности и особенности
AFTER DARK с сохранённой подписью
Новый постер сочетает глянцевый красный заголовок и One night only под женщиной в атласном платье. В medium, 1k, 2:3 обе строки верны. Назначьте каждой место, затем фигуру, неон и печатную фактуру вокруг. Это измеренный пример двух текстовых блоков; проверьте слова своего дизайна.
Название места над фестивальными деталями
LUMEN BAY сочетает крупное название и меньшую строку Summer Festival · July 12–14. Оба читаются в морской композиции с парусниками и полосатым маяком. Задайте разные места тексту до иллюстрации. Quality определяет тариф, а 1k и 2k стоят одинаково в его пределах.
Место для оранжерейного кота
В правке на дорожке появились скамья и спящий рыжий кот при прежних растениях и свете. Запрос называет добавления и сохранение остального. Для области используйте белую маску. Референсы и high тоже действовали в тестах, но каждый результат требует осмотра.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите изображение в пределах 10 000 символов, заключая нужные надписи в кавычки; длина промпта не определяет цену. Не менее 1 символов · Не более 10000 символов |
aspect_ratio | Нет | Задайте композицию через 1:1, 4:3, 3:4, 3:2, 2:3, 16:9 или 9:16; доплаты за пропорции нет. |
quality | Нет | Для генерации выберите low, medium (по умолчанию) или high; более высокое качество стоит дороже за изображение. |
resolution | Нет | Выберите размер 1k или 2k; цена выбранного уровня качества останется прежней. |
enable_prompt_expansion | Нет | Включите эту настройку, чтобы модель расширила короткую инструкцию до генерации; оплата по-прежнему зависит от качества. По умолчанию: |
Стоимость
Каждое созданное изображение оплачивается по выбранному качеству; разрешение и пропорции не меняют тариф, неудачные запросы не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.036 / изображение |
| $0.072 / изображение |
| $0.264 / изображение |
Сценарии использования
Ретроафиши кино и вечеров
Стройте композицию вокруг заголовка и отдельной строки события. AFTER DARK верно написал обе при medium, 1k, 2:3 с фигурой в атласном платье и ретрообработкой.
Туристические и фестивальные иллюстрации
Поместите название места над сценой, сведения о событии под ней. LUMEN BAY сохранил большой заголовок и мелкий фестивальный текст рядом с морем.
Небольшие добавления в готовую сцену
Назовите новый предмет и попросите сохранить место со светом. Оранжерея получила деревянную скамью и спящего рыжего кота, остальное осталось неизменным.
Дизайн-правки по референсам
Передайте картинки палитры, материала, стиля или содержания и объясните роли. Правка принимает четыре референса, с маской — три.
Контролируемая область композиции
Отметьте изменение белым на чёрно-белой маске и опишите область. High даёт сдержанность; тесты подтвердили маски и точность.
Руководство по промптам и практические советы
Выберите новую картинку или правку
Начните text-to-image для композиции в словах. Для сцены из готовой картинки выберите image-to-image и передайте
image_url.Отделите надписи от художественного задания
Заключите заголовок и подпись в кавычки, укажите места. Опишите окружение, одежду, свет или графическую фактуру вокруг букв.
Настройте качество и холст
Выберите quality для тарифа, затем 1k либо 2k и поддерживаемые пропорции. Исходно medium; у правки есть
very_low.Направьте изменение и проверьте
При правке добавьте необязательную маску белой области, пронумеруйте референсы по ролям. Проверьте текст и сохранение, скачайте принятое за 14 дней.
Композиция из слов
Ideogram 4.5 text-to-image начинает с описания сцены и размещает заданные надписи внутри. Подходит новому постеру, иллюстрированной обложке или графике события по письменному заданию. Текст в кавычках задаёт слова, художественные указания — изображение вокруг.
Два измеренных постера лежат в основе эндпоинта. LUMEN BAY соединил ясное название с мелкой фестивальной строкой. AFTER DARK перенёс красный глянцевый заголовок и One night only в ретрокомпозицию с женщиной в атласном платье. Это отдельные макеты без обещания для каждой фразы и расстановки.
Назначение параметров
| Параметр | Выбор или предел | Применение |
|---|---|---|
| prompt | До 10 000 символов | Композиция и обязательные надписи в кавычках. |
| quality | low, medium, high; исходно medium | Тариф за изображение. |
| resolution | 1k или 2k | Размер без изменения тарифа качества. |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | Форма под размещение. |
enable_prompt_expansion | Необязательное расширение | Дополнение короткой инструкции до генерации. |
В генерации нет very_low. Запрос с исходником относится к image-to-image с масками, визуальными референсами и точностью.
Тариф определяется качеством
Каждое выданное изображение оплачивается по quality. Переход low — medium — high повышает цену; смена 1k и 2k — нет. Семь форм тоже используют выбранный тариф. Длина prompt — вместимость задания, не единица оплаты.
До выбора смотрите страницу Ideogram 4.5. Неудачный запрос бесплатен. Разделяйте quality и холст: первое выбирает цену, остальное — размер и форму.
Надписи как часть макета
Работа каждого текстового блока
Решите слова до декора. Удобный порядок: заголовок, подпись, их места, затем сцена. Для AFTER DARK поставьте заголовок над фигурой, короткую строку события — у нижнего края.
Держите полную строку в кавычках, включая важную пунктуацию. Укажите доминирующую и меньшую строку, задавая иерархию вместо равнозначных слов. До использования сверяйте заголовок и подпись с заданием.
Конкретная сцена
Для людей опишите героя, одежду, место, настроение и свет. Женщина ближе к сорока в атласном вечернем платье у неонового кинотеатра — конкретнее неопределённого портрета. Мужчина сорока с лишним лет в рубашке с открытым воротом на платформе — другое направление. Предлагаемые герои — от тридцати лет.
Выберите поддерживающую графику, например шелкографию и ограниченную палитру ретропостера. Укажите aspect_ratio настройкой наряду с местами текста. Высокий постер может использовать 2:3, широкое размещение — одну из горизонталей.
Расширение короткого начала
enable_prompt_expansion позволяет Ideogram дополнить короткую инструкцию перед картинкой. Тесты подтвердили действие. Даже с расширением самостоятельно напишите точные заголовок и сведения о событии: это ваше дизайнерское решение.
Результаты проверок
- LUMEN BAY чётко воспроизвёл название и Summer Festival · July 12–14.
- При medium, 1k и 2:3 AFTER DARK верно написал заголовок и One night only, показав оглядывающуюся фигуру в атласе.
- Расширение промпта действовало; это не устанавливает улучшение каждого запроса.
Мелкий текст проверяйте так же тщательно. Примеры поддерживают показанные схемы без измеренного успеха других макетов и длинных текстов.
Границы и следующий сценарий
Ideogram проверяет содержание на своей стороне; заблокированное отклоняется без платы. Файлы удаляются через 14 дней: скачайте выбранное с промптом и настройками.
Для сцены из готовой картинки выберите image-to-image этой страницы. Для SVG перейдите к Ideogram Vector 1. Для удаления фона фотографии — Ideogram Remove Background. Их материалы и результаты отличаются от нового постера.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/4.5/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.






