provod.ai / docs
Видео API

Генерация видео

Пример POST /v1/videos, параметры результата, первый кадр и ссылки на исходные изображения, аудио и видео.

Обновлено

Создание видео начинается с POST /v1/videos. Подготовьте API_BASE_URL и PROVOD_API_KEY, как показано в обзоре.

Видео по тексту

Замените MODEL_ID_FROM_CATALOG точным ID доступной модели. Пример рассчитан на модель, которая принимает текст без обязательных референсов и поддерживает 5 секунд, 720p, 16:9. Если каталог задаёт другие значения, измените их до отправки.

Terminal
export VIDEO_MODEL="MODEL_ID_FROM_CATALOG"

jq -n --arg model "$VIDEO_MODEL" '{
  model: $model,
  prompt: "A slow camera pan across a quiet mountain lake at sunrise.",
  duration: 5,
  resolution: "720p",
  aspect_ratio: "16:9"
}' > video-request.json

curl --fail-with-body --silent --show-error \
  "$API_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @video-request.json -o video-job.json

jq '{id, status, polling_url}' video-job.json

Ответ 202 подтверждает создание задачи. Он не означает, что генерация уже завершилась. Сохраните video-job.json для проверки результата.

Поля запроса

ПолеНазначение
modelОбязательный публичный ID модели
promptОписание сцены, до 8 000 символов; требования модели могут быть строже
durationЦелое число секунд от 1 до 120, дополнительно ограниченное моделью
resolutionЗначение из каталога, например 720p
sizeРазмер вида 1280x720, если поддерживается
aspect_ratioСоотношение сторон, например 16:9
generate_audioГенерация звука, если поддерживается
seedЦелое число от 0 до 2 147 483 647, если поддерживается; не гарантия одинакового результата
callback_urlПубличный HTTPS-адрес для уведомления о результате

Первый и последний кадр

Добавьте frame_images к основному запросу. first_frame и last_frame допустимы только при поддержке выбранной моделью.

Request fields
{
  "frame_images": [
    {
      "type": "image_url",
      "frame_type": "first_frame",
      "image_url": {"url": "https://media.example.com/first-frame.jpg"}
    }
  ]
}

Замените пример URL действительной ссылкой. Ограничения input_constraints.image распространяются и на кадры.

Изображения, аудио и видео как референсы

input_references содержит объекты с типом и вложенным URL. Ниже показана форма трёх типов; оставьте только необходимые и поддерживаемые выбранной моделью элементы.

Request fields
{
  "input_references": [
    {"type": "image_url", "image_url": {"url": "https://media.example.com/reference.jpg"}},
    {"type": "audio_url", "audio_url": {"url": "https://media.example.com/reference.mp3"}},
    {"type": "video_url", "video_url": {"url": "https://media.example.com/reference.mp4"}}
  ]
}

Каждый тип из required_input_reference_types должен присутствовать. Учитывайте ограничения длительности, размера, MIME-типа и количества файлов. Если reference_audio_requires_visual_input включён, к аудио нужен визуальный материал; также проверяйте maximum_reference_audio_duration_seconds.

Для API используйте доступные поставщику HTTPS-ссылки без cookies и заголовка авторизации. Локальный путь на вашем компьютере не подходит. Срок жизни временной ссылки должен покрывать очередь и обработку задачи. Загрузка файлов в кабинете — отдельный интерфейс с авторизацией сессией; публичной multipart-ручки /v1/videos/input-assets нет.

Звук и дополнительные параметры

generate_audio=true запрашивает генерацию звука. Наличие аудиореференса само по себе не подтверждает сохранение исходной речи, voice cloning или lip-sync. Используйте такой режим только при подтверждённом контракте конкретной модели; универсальной гарантии для всех видеомоделей нет.

allowed_passthrough_parameters перечисляет дополнительные разрешённые поля. Не переносите поля вроде корневого audio из API другого сервиса без проверки нашего контракта. provider и дополнительные настройки тоже зависят от поддерживаемого маршрута.

Если создание не удалось

При ошибке валидации проверьте поля и допустимое сочетание в каталоге. При обрыве HTTP после отправки не повторяйте создание автоматически: задача уже могла появиться. Публичного контракта идемпотентности для POST /v1/videos нет; повтор может создать и оплатить ещё одну генерацию.

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

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