Генерация видео
Пример POST /v1/videos, параметры результата, первый кадр и ссылки на исходные изображения, аудио и видео.
Обновлено
Создание видео начинается с POST /v1/videos. Подготовьте API_BASE_URL и PROVOD_API_KEY, как показано в обзоре.
Видео по тексту
Замените MODEL_ID_FROM_CATALOG точным ID доступной модели. Пример рассчитан на модель, которая принимает текст без обязательных референсов и поддерживает 5 секунд, 720p, 16:9. Если каталог задаёт другие значения, измените их до отправки.
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 допустимы только при поддержке выбранной моделью.
{
"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. Ниже показана форма трёх типов; оставьте только необходимые и поддерживаемые выбранной моделью элементы.
{
"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 нет; повтор может создать и оплатить ещё одну генерацию.