Посібник з налаштування 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. Перегляньте документацію провайдера щодо специфічних вимог до конфігурації