provod.ai / docs
Видео API

Видео API

Как выбрать видеомодель, проверить параметры и стоимость, создать задачу и получить готовое видео.

Обновлено

Создание видео и получение результата

Видео генерируется фоновой задачей. POST /v1/videos возвращает 202 и ID задачи; готовый файл получают отдельным запросом.

ШагРучкаРезультат
Выбрать модельGET /v1/videos/modelsКаталог параметров и цен
Создать видеоPOST /v1/videosID и polling_url
Проверить задачуGET /v1/videos/{id}Статус и результат
Скачать файлGET /v1/videos/{id}/content?index=0Байты видео

Используйте API-ключ рабочего пространства. Ручки доступны также с префиксом /api/v1/videos. Не добавляйте /v1 дважды.

Выбор модели

Terminal
export API_BASE_URL="https://api.provod.ai"
export PROVOD_API_KEY="YOUR_API_KEY"

curl --fail-with-body --silent --show-error \
  "$API_BASE_URL/v1/videos/models" \
  -H "Authorization: Bearer $PROVOD_API_KEY" -o video-models.json

jq '.data[] | {id, available, supported_durations, supported_resolutions,
  supported_aspect_ratios, required_input_reference_types, currency,
  minimum_price_per_second}' video-models.json

В model передавайте точный id. Для поиска в общем каталоге также есть GET /api/models?kind=video; примеры этой страницы используют специализированный /v1/videos/models и его названия полей.

Проверяйте available и unavailable_reason, затем ограничения выбранной модели:

  • supported_durations, supported_resolutions, supported_sizes, supported_aspect_ratios — параметры результата;
  • supported_frame_images — поддержка первого и последнего кадра;
  • supported_input_reference_types и required_input_reference_types — допустимые и обязательные исходные материалы;
  • input_constraints — известные ограничения файлов;
  • generate_audio и seed — поддержка соответствующих настроек.

null или отсутствующая граница не означают отсутствие ограничений. Наличие отдельных значений в каталоге не гарантирует совместимость всех их сочетаний. Доступность модели также не гарантирует успешный ответ на любой запрос.

Стоимость и баланс

currency задаёт валюту каталога. minimum_price_per_second — минимальная оценка за секунду, а не точная цена любого режима. Итог зависит от модели и выбранного варианта, включая разрешение и звук. Не умножайте минимальную цену на длительность как гарантированную стоимость.

При создании задачи сумма резервируется; после успешного завершения списание выполняется по сохранённому тарифу. При окончательной ошибке резерв освобождается. Пока задача выполняется или повторяется внутри сервиса, резерв может оставаться активным. Итог проверяйте в расходах.

В публичном ответе usage.cost, когда он присутствует, выражен в USD. Это не сумма в рублях. Для provod.ai фактические рублёвые списания отражены в истории баланса. usage.is_byok равен false.

Публичной ручки расчёта точной цены с API-ключом сейчас нет. Оценка в кабинете относится к его авторизованному интерфейсу и не является /v1/videos/quote.

С чего начать

Выберите модель без обязательных исходных материалов и создайте видео по тексту. Затем сохраните ID и настройте опрос статуса или webhook.

Решение проблем

На этой странице