Видео API
Как выбрать видеомодель, проверить параметры и стоимость, создать задачу и получить готовое видео.
Обновлено
Видео генерируется фоновой задачей. POST /v1/videos возвращает 202 и ID задачи; готовый файл получают отдельным запросом.
| Шаг | Ручка | Результат |
|---|---|---|
| Выбрать модель | GET /v1/videos/models | Каталог параметров и цен |
| Создать видео | POST /v1/videos | ID и polling_url |
| Проверить задачу | GET /v1/videos/{id} | Статус и результат |
| Скачать файл | GET /v1/videos/{id}/content?index=0 | Байты видео |
Используйте API-ключ рабочего пространства. Ручки доступны также с префиксом /api/v1/videos. Не добавляйте /v1 дважды.
Выбор модели
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.