Введение
Что делает этот эндпоинт
Создаёт один SVG по текстовому prompt с помощью Ideogram Vector 1.0. Файл состоит из контуров и градиентов, поэтому масштабируется до любого размера и открывается как набор редактируемых фигур.
Основные входные данные
prompt описывает дизайн. quality задаёт low, medium или high. aspect_ratio выбирает форму холста из 17 соотношений сторон. reference_image_urls — необязательный параметр: до пяти изображений, задающих стиль.
Что вы получите
Один файл .svg на запрос (MIME image/svg+xml).
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Выходной формат | SVG (контуры, линейные и радиальные градиенты) |
| Источник для векторизации | JPEG, PNG или WebP, до 50 MB |
| Длина prompt | До 9,500 символов |
| Референсы | До 5 при создании работы |
Ключевые возможности и особенности
Портрет в кафе, воссозданный из плоских цветовых фигур
Мы векторизовали фотографию 1024×1536 с настройкой detailed. SVG содержал около 2,000 контуров и 580 градиентов: волосы, вязаная ткань и свет из окна превратились в постеризованные цветовые области, сохранив узнаваемость сцены. Размер файла составил около 2 MB.
Плоский значок PNG превращается в 17 аккуратных контуров
Значок кофейной чашки, экспортированный в PNG, превратился в SVG размером 6 KB. Обводки, завитки пара и эмблема с листом соответствуют растру. Каждая фигура — отдельный контур, поэтому в векторном редакторе цвет меняется одним щелчком.
simple объединяет мелкие фигуры
Слева — оригинал, в центре — результат simple, справа — detailed. simple сократил число контуров примерно с 2,000 до менее 1,000, а размер файла — с 2 MB до 1.1 MB. Мелкие границы волос и свитера стали более крупными областями.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите объект, стиль (плоский, линейный, геометрический), цвета и нужные надписи. Не менее 1 символов · Не более 9500 символов |
quality | Нет | low, medium (по умолчанию) или high. Чем выше уровень, тем больше деталей и дольше обработка. |
aspect_ratio | Нет | Форма холста для вектора: от вертикального 1:4 до горизонтального 4:1; по умолчанию 1:1. |
reference_image_urls | Нет | Необязательно: до пяти изображений JPEG, PNG или WebP размером до 10 MB каждое как образцы стиля и композиции. Первое влияет сильнее всего. Не более 5 элементов |
Стоимость
Каждый готовый SVG оплачивается один раз по тарифу выбранного уровня качества. Референсы повышают тариф только при high. Неудачные запросы и запросы без результата SVG не оплачиваются.
| With references | Качество: low | Качество: medium | Качество: high |
|---|---|---|---|
| $0.174 / изображение | $0.216 / изображение | $0.264 / изображение |
| $0.174 / изображение | $0.216 / изображение | $0.432 / изображение |
Сценарии использования
Логотипы и фирменные знаки с надписями
Запросите знак с коротким названием и получите буквы в виде векторных контуров, которые останутся чёткими на визитке или вывеске.
Восстановите логотип низкого разрешения
Векторизуйте старый логотип в PNG или JPEG в формат SVG, чтобы напечатать его крупно, перекрасить или передать в типографию.
Плакаты, наклейки и файлы для резки
Создайте плакат или наклейку из векторных фигур либо векторизуйте работу для режущих плоттеров, лазерных граверов и программ для вышивки.
Руководство по промптам и практические советы
Выберите задачу
Отправьте prompt для нового дизайна (text-to-image) или
image_urlдля векторизации готового изображения (edit). Запросы сimage_urlавтоматически направляются на векторизацию.Задайте настройки
Для новой работы выберите quality и
aspect_ratioи при желании добавьте до пяти референсов. Для векторизации задайтеdetail_level: detailed или simple.Скачайте SVG
Проверяйте статус задачи и скачайте .svg из хранилища платформы. Откройте его в Figma, Illustrator или Inkscape — контуры и заливки сразу доступны для редактирования.
Введение
Функция преобразования текста в SVG в Ideogram Vector 1.0 рисует новый векторный файл по описанию. Она подходит для логотипов, эмблем, плакатов, наклеек и простых иллюстраций, которые должны оставаться чёткими при любом размере.
Основные функции и преимущества
Настоящий векторный результат
Модель возвращает элементы контуров и градиентов, а не картинку в оболочке SVG. Откройте файл в Figma, Illustrator или Inkscape — каждую фигуру можно выделить отдельно.
Читаемые надписи
Ideogram известен работой с типографикой. В наших тестах короткие надписи вроде FOXTROT и NORTH SHORE были написаны правильно и встроены в композицию.
Три уровня и 17 соотношений сторон
low подходит для быстрых набросков, medium — для большинства задач, high — для максимальной детализации. Холст варьируется от вертикального 1:4 до горизонтального 4:1.
Примеры использования
Создайте основу фирменного знака
Сгенерируйте несколько вариантов логотипа, затем доработайте выбранный в векторном редакторе.
Плакаты для событий и магазинов
Создайте плакат с заголовком, который можно напечатать в A2 без пикселизации.
Наклейки и сувениры
Создавайте дизайны для резки винила, шелкографии и вышивки, где нужны векторные файлы.
Руководство по prompt и советы
Явно опишите стиль
Слова «плоский», «геометрический», «линейный рисунок», «двухцветный» или «эмблема» помогают модели сохранить формы простыми и удобными для редактирования.
Заключите надписи в кавычки или напишите прописными
Укажите точный текст для изображения и ограничьтесь несколькими словами.
Назовите цвета
Управления палитрой нет, поэтому перечислите цвета в prompt, например тёмно-синий и персиковый.
Быстрый старт 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/vector-1/text-to-image",
"input": {
"aspect_ratio": "1:1",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium"
}
}'
# 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.
