Введение
Передайте исходник в image_url и опишите нужную правку. Маска с белыми участками на чёрном фоне может задать область изменений, референсы — стиль или содержание, а высокая точность — ограничить масштаб правки.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Издатель | 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 символов |
image_url | Да | Передайте сюда изображение для изменения; за исходник отдельная плата не взимается. Не менее 1 символов |
mask_url | Нет | При желании передайте чёрно-белую маску с белыми областями для изменения; её использование не меняет цену. Не менее 1 символов |
reference_image_urls | Нет | Добавьте до четырёх референсов содержания или стиля, либо до трёх с маской, обозначив их Image 1 и далее; число референсов не влияет на оплату. Не более 4 элементов |
aspect_ratio | Нет | Задайте холст для правки как 1:1, 4:3, 3:4, 3:2, 2:3, 16:9 или 9:16; все семь форм оплачиваются по выбранному качеству. |
quality | Нет | Для правки доступны |
resolution | Нет | Результат редактирования доступен в 1k или 2k без повышения цены за размер. |
edit_precision | Нет | Выберите regular или high: high сильнее ограничивает изменения; дополнительного тарифа за этот выбор нет. |
Стоимость
Цена правки зависит от качества, включая более доступный вариант very_low; размер, пропорции и число референсов не добавляют плату, неудачные правки не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.0096 / изображение |
| $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 image-to-image берёт image_url и применяет правку prompt. Подходит готовой сцене: добавить предмет, изменить деталь или внести визуальное направление. Назовите изменение и сохраняемое, чтобы обе части задания были ясны.
В оранжерею добавились деревянная скамья и спящий рыжий кот на каменной дорожке при прежних растениях и свете. Отдельные проверки подтвердили маски, референсы и high edit precision. Это поддерживает настройки без установления идеального сохранения каждого запроса.
Настройки правки
| Параметр | Значения или предел | Роль |
|---|---|---|
image_url | Исходная картинка | Изменяемое изображение. |
| prompt | До 10 000 символов | Правка, сохранение, надписи в кавычках. |
mask_url | Необязательная чёрно-белая маска | Белая область меняется. |
reference_image_urls | До четырёх, с маской до трёх | Стиль или содержание, Image 1 и далее. |
edit_precision | regular либо high | High сдерживает изменение. |
| quality | very_low, low, medium, high; исходно medium | Цена картинки. |
| resolution | 1k или 2k | Размер выдачи. |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | Форма холста правки. |
Quality и edit_precision отвечают на разные вопросы. Quality выбирается для тарифа, edit_precision — для сдержанности изменения. High precision не равно high quality.
Инструкция вокруг источника
Изменение отдельно от сохранения
Начните с действия: добавить скамью, перекрасить этикетку, изменить названное. Затем сохраняемые растения, стол, свет или форма. Общая просьба улучшить картинку не объясняет важные части источника.
В оранжерее точное задание называет место скамьи и спящего кота, затем сохраняет окружение. Для букв заключите точный текст в кавычки и задайте место. Проверяйте и прежние сохраняемые слова, и новые.
Область через маску
Необязательная маска чёрно-белая; белым отмечается правка. Опишите происходящее внутри и сохраняемое вокруг. Тест подтвердил действие маски, но не одинаковость всех границ и деталей в каждом запуске.
При добавлении mask_url пересчитайте референсы. Без маски четыре, с маской три. Уменьшается список референсов; image_url по-прежнему задаёт исходник.
Отдельные роли референсов
Источник задаёт изменяемое, референс — желаемый стиль или содержание. Называйте их Image 1, Image 2 и далее, поясняя вклад. Ботаническая палитра может направлять этикетку без замены формы товара.
При нескольких входах дайте краткую карту: один материал, другой цвета. Завершите сохранением источника. Тесты подтверждают работу референсов, а не перенос каждой детали каждого.
Проверка до продолжения
Сверьте названные точки: новый предмет, сохранённую сцену, текст и холст. Оранжерея сохранила растения и свет вокруг скамьи и кота. Это единичное изменение, не гарантия длинной цепочки.
Для нескольких правок держите принятую версию, конкретизируйте следующую. Проверяйте каждую картинку до нового шага. Для людей используйте разрешённые фото совершеннолетних без имитации личности.
Что определяет счёт
Правка оплачивается за картинку по quality; very_low — более дешёвый уровень правок. Более высокое качество дороже. Размер, пропорции и число референсов цену не меняют; precision отдельного тарифа не добавляет. Ошибка бесплатна.
Текущая цена — на странице Ideogram 4.5. Выбирайте 1k/2k и форму под применение, quality — под бюджет. Маска и референс направляют задачу, не создают новую единицу оплаты.
Пределы и связанные инструменты
Ideogram применяет свой фильтр, отмеченные запросы отклоняет без платы. Сохраните выбранные изображения в течение 14 дней, пока они не удалены.
Для новой сцены вернитесь к text-to-image. Ideogram Remove Background даёт фотовырезку, Ideogram Vector 1 — SVG. Выбирайте по входу и выходу, не предполагая, что инструкция правки меняет тип файла.
Быстрый старт 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/edit",
"input": {
"edit_precision": "regular",
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# 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.







