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

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

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

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

- **URL**: Эффективны для публично доступных видео, так как не требуют локального кодирования
- **Base64 Data URL**: Требуются для локальных файлов или приватных видео, которые не являются публично доступными

<Info>
  **Важно:** Поддержка видео URL различается у разных провайдеров. RouterAI отправляет видео URL только тем провайдерам, которые явно их поддерживают. Например, Google Gemini на AI Studio поддерживает только ссылки YouTube (не Vertex AI).
</Info>

<Warning>
  **Только API:** Видео входные данные в настоящее время поддерживаются только через API. Загрузка видео недоступна в интерфейсе чата RouterAI в данный момент.
</Warning>

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

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

Вы можете искать модели с поддержкой видео, фильтруя по модальности видео входа на нашей [странице Моделей](/models?input_modalities[]=video).

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

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

```bash
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:**

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

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

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

```bash
# Сначала кодируем видео
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 кодирования для больших файлов

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

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