О модели 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 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model ideogram/vector-1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте 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-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.