Полная документация API: Генерация медиа
Обзор
Режимы работы
- Text-to-Video
- Image-to-Video
- Video-to-Video
- First/Last Frames
Только текстовый промпт — модель генерирует ролик с нуля.
Параметры
Параметр
async: true — обязателен для всех запросов: генерация видео возвращает id сразу, а готовый ролик приходит позже.Пример запроса (cURL)
Асинхронная генерация
Генерация видео — асинхронный процесс. После отправки запроса вы получитеid, который нужно использовать для проверки статуса:
1
Отправка запроса
POST на
/api/v1/media возвращает id генерации2
Проверка статуса
GET на
/api/v1/media/{id} возвращает текущий статус3
Получение результата
Когда статус
completed, в ответе будет URL готового видеоСоветы и лучшие практики
Описывайте движение
Описывайте движение
В промпте явно указывайте, что должно двигаться: «камера приближается», «объект вращается», «человек бежит». Без этого модель может выдать статичную сцену.
Следите за duration и разрешением
Следите за duration и разрешением
Большие значения
duration (8–10 сек) и 4k заметно увеличивают время и стоимость генерации. Для тестов используйте 720p + duration: 4.Передавайте файлы по URL
Передавайте файлы по URL
images[] и videos[] принимают публичные URL в формате { "type": "url", "data": "https://..." }. Для приватных файлов сначала загрузите их через /v1/storage/upload (см. Хранилище файлов).Соблюдайте квоту референсов
Соблюдайте квоту референсов
Суммарное число референсов ограничено:
images + videos×2 + character_ids ≤ 7. Если передать больше — модель вернёт ошибку.first/last frames — не сочетаются с другими референсами
first/last frames — не сочетаются с другими референсами
first_frame_url и last_frame_url — это самостоятельный режим. Их нельзя использовать вместе с images, videos, audio_ids или character_ids.Следующие шаги
Статус генерации
Проверка статуса генерации медиа
Хранилище файлов
Загрузка изображений и видео