Руководство по настройке OpenAI-совместимого API

1Выберите совместимого провайдера

Выберите сервис, поддерживающий протокол WebSocket Realtime API от OpenAI. Важно: Очень немногие провайдеры в настоящее время поддерживают Realtime API — большинство OpenAI-совместимых сервисов поддерживают только API Chat Completions, чего недостаточно. Всегда убеждайтесь, что ваш провайдер явно поддерживает Realtime API, прежде чем продолжать.

2Получите конечную точку API и ключ

Получите URL конечной точки API и API-ключ от выбранного провайдера. URL конечной точки обычно имеет формат https://your-provider.com или http://localhost:8080 для самостоятельно размещённых сервисов.

3Выберите OpenAI-совместимый API в Sokuji

Откройте Sokuji и перейдите в панель настроек. Выберите "OpenAI Compatible API" в качестве провайдера ИИ в раскрывающемся меню провайдеров.

4Введите конфигурацию

Вставьте URL пользовательской конечной точки API в поле "API Endpoint". Введите API-ключ в поле "API Key". Если ваш провайдер не требует API-ключ (например, локальные сервисы), вы можете оставить поле пустым или ввести значение-заполнитель.

5Выберите модель и голос

Выберите настройки модели и голоса, которые поддерживает ваш провайдер. Доступные параметры зависят от конкретного провайдера. Распространённые модели включают gpt-4o-realtime-preview или специфичные для провайдера названия моделей.

6Протестируйте соединение

Запустите сеанс перевода, чтобы убедиться, что всё работает. Нажмите кнопку «Начать сеанс», говорите в микрофон и проверьте, что соединение успешно установлено и аудио переводится.

Что такое OpenAI-совместимый API?

OpenAI-совместимый API — это универсальная опция провайдера, позволяющая Sokuji подключаться к любому сервису, реализующему протокол Realtime API от OpenAI:

• Используйте любую OpenAI-совместимую конечную точку с пользовательским базовым URL
• Поддерживает как облачные, так и самостоятельно размещённые сервисы
• Гибкость переключения между различными провайдерами бэкенда
• Полезно для частных развёртываний, оптимизации затрат или регионального соответствия

О совместимости провайдеров

Большинство OpenAI-совместимых сервисов поддерживают только API Chat Completions. Realtime API (на основе WebSocket, с потоковой передачей аудио) — это другой протокол, и его поддерживают очень немногие провайдеры:

• Azure OpenAI Service: Поддерживает Realtime API с моделями OpenAI, размещёнными на Microsoft Azure
• Всегда проверяйте документацию провайдера на предмет явной поддержки Realtime API
• Сервисы вроде OpenRouter, Together AI и т.д. обычно НЕ поддерживают Realtime API
• Некоторые прокси-сервисы (например, CometAPI) могут предлагать совместимость с Realtime API — проверьте перед использованием
• Самостоятельно размещённые решения должны реализовывать полный протокол WebSocket Realtime API

Советы по настройке

• URL конечной точки не должен содержать завершающую косую черту (например, используйте https://api.example.com, а не https://api.example.com/)
• Для локальных сервисов используйте http://localhost:<port> в качестве конечной точки
• Некоторые провайдеры могут требовать специфические заголовки или методы аутентификации
• При использовании прокси-сервиса убедитесь, что он корректно пересылает WebSocket-соединения

Частые проблемы

Отказ в подключении: Убедитесь, что URL конечной точки правильный и сервис запущен. Для локальных сервисов проверьте, что сервер запущен и слушает на ожидаемом порту.

Ошибка аутентификации: Перепроверьте свой API-ключ. Некоторые провайдеры требуют определённые форматы ключей. Убедитесь, что ваш аккаунт имеет доступ к Realtime API.

Модель не найдена: Название модели может отличаться от стандартных моделей OpenAI. Проверьте документацию провайдера для доступных названий моделей.

Ошибка WebSocket-соединения: Убедитесь, что ваш провайдер поддерживает WebSocket-соединения для Realtime API. Стандартные HTTP-конечные точки (Chat Completions) работать не будут.

Проверка совместимости провайдера

1. Убедитесь, что ваш провайдер явно поддерживает протокол Realtime API от OpenAI
2. Проверьте поддержку WebSocket-соединений (не только REST API)
3. Подтвердите, что провайдер поддерживает потоковую передачу аудио ввода/вывода
4. Протестируйте URL конечной точки напрямую с помощью WebSocket-клиента, если возможно
5. Изучите документацию провайдера на предмет специфических требований к конфигурации