Загрузка...

Видео входные данные

Отправляйте видеофайлы моделям с поддержкой видео через API RouterAI.

RouterAI поддерживает отправку видеофайлов совместимым моделям через API. Это руководство покажет вам, как работать с видео, используя наш API.

RouterAI поддерживает как прямые URL, так и base64-кодированные data URL для видео:

  • URL: Эффективны для публично доступных видео, так как не требуют локального кодирования
  • Base64 Data URL: Требуются для локальных файлов или приватных видео, которые не являются публично доступными
**Важно:** Поддержка видео URL различается у разных провайдеров. RouterAI отправляет видео URL только тем провайдерам, которые явно их поддерживают. Например, Google Gemini на AI Studio поддерживает только ссылки YouTube (не Vertex AI). **Только API:** Видео входные данные в настоящее время поддерживаются только через API. Загрузка видео недоступна в интерфейсе чата RouterAI в данный момент.

Видео входные данные

Запросы с видеофайлами к совместимым моделям доступны через API /api/v1/chat/completions с типом контента video_url. url может быть либо URL, либо base64-кодированным data URL. Обратите внимание, что только модели с возможностями обработки видео будут обрабатывать эти запросы.

Вы можете искать модели с поддержкой видео, фильтруя по модальности видео входа на нашей странице Моделей.

Использование видео URL

Вот как отправить видео, используя URL. Обратите внимание, что для Google Gemini на AI Studio поддерживаются только ссылки YouTube:

curl https://routerai.ru/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ROUTERAI_API_KEY" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Пожалуйста, опишите, что происходит в этом видео."
          },
          {
            "type": "video_url",
            "video_url": {
              "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
            }
          }
        ]
      }
    ]
  }'

Использование Base64 кодированных видео

Для локально хранящихся видео вы можете отправлять их, используя base64 кодирование как data URL:

Подготовка base64 кодированного видео в Linux:

# Кодирование видеофайла в base64 и сохранение в переменную
VIDEO_BASE64=$(base64 -w 0 path/to/your/video.mp4)

# Создание data URL
VIDEO_DATA_URL="data:video/mp4;base64,$VIDEO_BASE64"

Отправка запроса с base64 видео:

# Сначала кодируем видео
VIDEO_BASE64=$(base64 -w 0 path/to/your/video.mp4)
VIDEO_DATA_URL="data:video/mp4;base64,$VIDEO_BASE64"

# Затем отправляем запрос
curl https://routerai.ru/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ROUTERAI_API_KEY" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Что в этом видео?"
          },
          {
            "type": "video_url",
            "video_url": {
              "url": "'"$VIDEO_DATA_URL"'"
            }
          }
        ]
      }
    ]
  }'

Поддерживаемые форматы видео

RouterAI поддерживает следующие форматы видео:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/webm

Распространенные случаи использования

Видео входы позволяют реализовать широкий спектр приложений:

  • Суммаризация видео: Генерация текстовых резюме видеоконтента
  • Распознавание объектов и действий: Идентификация объектов, людей и действий в видео
  • Понимание сцены: Описание обстановки, окружения и контекста
  • Анализ спорта: Анализ игрового процесса, движений и тактики
  • Наблюдение: Мониторинг и анализ записей с камер безопасности
  • Образовательный контент: Анализ обучающих видео и предоставление инсайтов

Лучшие практики

Соображения по размеру файла

Видеофайлы могут быть большими, что влияет как на время загрузки, так и на стоимость обработки:

  • Сжимайте видео, когда это возможно, чтобы уменьшить размер файла без значительной потери качества
  • Обрезайте видео, чтобы включить только релевантные сегменты
  • Учитывайте разрешение: Более низкие разрешения (например, 720p вместо 4K) уменьшают размер файла, сохраняя при этом пригодность для большинства задач анализа
  • Частота кадров: Более низкая частота кадров может уменьшить размер файла для видео, где высокое временное разрешение не критично

Оптимальная длина видео

Разные модели могут иметь разные ограничения на продолжительность видео:

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

Компромиссы между качеством и размером

Балансируйте качество видео с практическими соображениями:

  • Высокое качество (1080p+, высокий битрейт): Лучше всего для детального визуального анализа, обнаружения объектов, распознавания текста
  • Среднее качество (720p, умеренный битрейт): Подходит для большинства общих задач анализа
  • Низкое качество (480p, низкий битрейт): Приемлемо для базового понимания сцены и распознавания действий

Поддержка видео URL у конкретных провайдеров

Поддержка видео URL значительно различается у разных провайдеров:

  • Google Gemini (AI Studio): Поддерживает только ссылки YouTube (например, https://www.youtube.com/watch?v=...)
  • Google Gemini (Vertex AI): Не поддерживает видео URL - используйте вместо этого base64-кодированные data URL
  • Другие провайдеры: Проверьте документацию конкретной модели на поддержку видео URL

Устранение неполадок

Видео не обрабатывается?

  • Убедитесь, что модель поддерживает видео вход (проверьте, что input_modalities включает "video")
  • Если используете видео URL, подтвердите, что провайдер поддерживает видео URL (см. раздел “Поддержка видео URL у конкретных провайдеров” выше)
  • Для Gemini на AI Studio убедитесь, что используете ссылку YouTube, а не прямой URL видеофайла
  • Если видео URL не работает, попробуйте использовать base64-кодированный data URL вместо этого
  • Проверьте, что формат видео поддерживается
  • Убедитесь, что видеофайл не поврежден

Ошибки с большими файлами?

  • Сжмите видео, чтобы уменьшить размер файла
  • Уменьшите разрешение видео или частоту кадров
  • Обрежьте видео до более короткой продолжительности
  • Проверьте ограничения на размер файла для конкретной модели
  • Рассмотрите использование видео URL (если поддерживается провайдером) вместо base64 кодирования для больших файлов

Плохие результаты анализа?

  • Убедитесь, что качество видео достаточно для задачи
  • Предоставьте четкие, конкретные промпты о том, что нужно проанализировать
  • Рассмотрите, подходит ли продолжительность видео для модели
  • Проверьте, хорошо ли виден и освещен контент видео