GetRouterДокументация
  • Русский

    • Видео

    Генерация видео выполняется асинхронно. Создайте задачу, сохраните её идентификатор, опрашивайте состояние и после завершения скачайте результат.

    Основные эндпоинты для видео:

    POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content

    Создание задачи генерации видео

    Эндпоинт /v1/videos принимает данные формы multipart:

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Бумажный самолётик летит по тихому современному офису" \
  -F "seconds=8"

    Для создания видео на основе изображения добавьте исходный файл, если модель это поддерживает:

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Добавь медленное приближение камеры и лёгкое движение" \
  -F "seconds=8" \
  -F "[email protected]"

    Успешный ответ содержит идентификатор задачи, например id, а также доступные метаданные: состояние, ход выполнения, модель, длительность или временные метки.

    Проверка состояния задачи

    curl https://getrouter.ai/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

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

    Скачивание результата

    После завершения задачи:

    curl -L https://getrouter.ai/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

    Рекомендуемый порядок работы с задачей

    1. До отправки проверьте модель, длительность и входные данные.
    2. Отправьте задачу один раз.
    3. Сохраните возвращённый идентификатор задачи.
    4. Увеличивайте интервалы между опросами вместо частых повторных запросов.
    5. Записывайте конечные ошибки для устранения неполадок.
    6. Скачивайте готовый результат без лишней задержки.
    Warning

    Если запрос состояния завершился по тайм-ауту, не создавайте новую задачу автоматически. Сначала запросите исходную задачу по её идентификатору, чтобы избежать повторной генерации и двойной оплаты.

    API для видео, специфичные для провайдеров

    Спецификация API также включает совместимые с провайдерами пути для видео, в том числе форматы задач в стиле Kling и другие варианты. Поля запросов и ответы о состоянии в этих эндпоинтах различаются. Для новых интеграций используйте основной сценарий /v1/videos, если модели или существующему клиенту не требуется путь, специфичный для провайдера.

    Актуальные пути и схемы приведены в справочнике API.

    Контроль расходов

    Стоимость видео может зависеть от модели, длительности, разрешения, качества или типа входных данных. Проверьте страницу Pricing и начинайте с коротких тестовых задач, прежде чем запускать пакетную генерацию.

    Что дальше