Ideogram Vector 1.0 API

О модели Ideogram Vector 1.0

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

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

Введение

Ideogram Vector 1.0 Text to SVG рисует новый векторный файл по текстовому описанию.

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

Нативный векторный вывод

Модель возвращает элементы path и градиентов, а не изображение внутри SVG-обёртки.

Читаемые надписи

Ideogram известен работой с типографикой. В наших запусках короткие слова, например FOXTROT и NORTH SHORE, вышли с правильным написанием и были встроены в композицию.

Три уровня и 17 соотношений сторон

Low подходит для быстрых черновиков, medium — для большинства задач, high — для максимальной детализации. Холст может быть от вертикального 1:4 до горизонтального 4:1.

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

Цены

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

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

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

Создание знака бренда

Сгенерируйте несколько вариантов логотипа и доработайте выбранный в векторном редакторе.

Афиши мероприятий и магазинов

Создайте афишу с заголовком, который печатается в A2 без пикселизации.

Наклейки и сувенирная продукция

Делайте макеты для вырубки винила, шелкографии или вышивки, где нужны векторные файлы.

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

Заключайте слова в кавычки или пишите заглавными

Указывайте точный текст, который нужно вывести надписью, и держите его в пару слов.

Называйте цвета

Управления палитрой нет, поэтому перечисляйте цвета в промпте, например тёмно-синий и персиковый.

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

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

1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
2. Отправьте запрос. Отправьте POST /jobs/createTask с model ideogram/vector-1/text-to-image и объектом 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/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}'

# 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

Ещё о Ideogram Vector 1.0

Попробовать

Ideogram Vector 1.0: нейросеть для картинок онлайнСоздавайте изображения с Ideogram Vector 1.0 в PopNow

Эндпоинты

Ideogram Vector 1.0 · Изображение в SVG

Документация

ID модели и схема входных данных Ideogram Vector 1.0 в документации APIБыстрый старт с API PopNow: отправьте первый запросРуководство по генерации изображений через API PopNowВебхуки: результаты Ideogram Vector 1.0 без опроса