Ideogram Vector 1.0 API

от Ideogram

SVG-векторы по запросу или изображению, с чистым текстом

ideogram/vector-1/edit
  • До 5 референсов
  • Соотношений сторон: 17
  • Генератор SVG
  • Изображение в SVG

О модели Ideogram Vector 1.0

SVG-векторы по запросу или изображению, с чистым текстом.

Вызывайте его по имени модели ideogram/vector-1/edit через POST /jobs/createTask, от 0,132 $.

Введение

Image to SVG принимает растровое изображение и возвращает векторный файл. Отправьте скриншот логотипа, PNG-иконку или фото и получите SVG, который можно масштабировать, перекрашивать и редактировать.

Ключевые возможности

Редактируемые контуры

Результат строится из элементов path и градиентов, без встроенного изображения. Каждая цветовая область — отдельная фигура.

Два режима детализации

Detailed точно следует исходнику. Simple объединяет мелкие области, что подходит для стилизованных изображений и более лёгких файлов.

Без промпта

Изображение и есть весь запрос; вектор сохраняет пропорции.

Параметры запроса

ПараметрОбязательныйОписание
detail_levelНетdetailed сохраняет более мелкие формы; simple объединяет их в меньшее число более крупных. Стоимость одинаковая. detailed · simple · По умолчанию: detailed
image_urlДаКартинка, с которой всё начинается.

Цены

Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

ВариантUSD за изображение
Стандарт0,132 $

До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.

Сценарии использования

Логотипы низкого разрешения

Превратите маленький PNG-логотип в вектор для вывесок, печати и сувенирной продукции.

Наборы иконок

Конвертируйте растровые иконки в SVG, чтобы они оставались чёткими в приложениях и на сайтах.

Руководство по промптам и советы

Используйте чистый исходник

Берите самую большую и резкую версию, желательно на однотонном фоне. Артефакты сжатия превращаются в лишние фигуры.

Для стилизованного искусства выбирайте simple

Если результат detailed содержит слишком много мелких фигур, запустите simple — получите более крупные области и меньший файл.

Фото дают большие файлы

Полное фото может дать тысячи контуров и файл размером 1–2 МБ; иконки обычно занимают несколько килобайт.

Быстрый старт API

Вызов API Ideogram Vector 1.0 в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model ideogram/vector-1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "ideogram/vector-1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "detail_level": "detailed"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.

Вопросы об API Ideogram Vector 1.0

Сколько стоит API Ideogram Vector 1.0?

Ideogram Vector 1.0 стоит от 0,132 $ за изображение — на самой дешёвой задаче «Изображение в SVG». API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

Какое имя модели у Ideogram Vector 1.0 в API?

Укажите ideogram/vector-1/edit — Изображение в SVG; ideogram/vector-1/text-to-image — Генератор SVG в поле model запроса POST /jobs/createTask.

Результат — настоящий вектор или картинка внутри SVG?

Это настоящий вектор. Во всех файлах из наших тестов были только элементы path, gradient и stop, без встроенных изображений. Перед выдачей каждый результат также проверяется: SVG со встроенным растром отклоняются.

Какой уровень детализации выбрать для логотипа?

Начните с detailed. Для плоского значка оба режима дали одинаковый файл. Разница видна на фотографиях и сложных иллюстрациях: simple объединяет мелкие фигуры в крупные области и уменьшает размер файла примерно вдвое.

Для чего нужны референсы?

Они задают стиль и композицию, причём первое изображение влияет сильнее всего. Можно приложить до пяти изображений размером до 10 MB каждое. Упоминать их в prompt не нужно.

Можно ли загрузить SVG, PDF или AI для векторизации?

Нет. Векторизация принимает JPEG, PNG или WebP размером до 50 MB. Чтобы доработать готовый вектор, откройте его в редакторе.

Какие ограничения у API Ideogram Vector 1.0?

Максимальный размер загрузки: 50 MB. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать Ideogram Vector 1.0 без кода?

Запускайте Ideogram Vector 1.0 в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.

Ещё о Ideogram Vector 1.0