Посібник з налаштування PalabraAI
Огляд
Цей посібник допоможе вам налаштувати PalabraAI для використання з Sokuji. PalabraAI спеціалізується на WebRTC-перекладі в реальному часі з мінімальною затримкою, що робить його ідеальним для живих розмов.
Спеціалізація
PalabraAI оптимізований спеціально для перекладу в реальному часі з підтримкою понад 60 мов-джерел та понад 40 цільових мов.
Два види облікових даних Palabra — Sokuji підтримує обидва
У Palabra дві окремі консолі, і кожна видає свій вид облікових даних. Platform (platform.palabra.ai/api-keys) видає єдиний API Key; старіший застосунок App (app.palabra.ai/dev/api-keys) видає пару Client ID + Client Secret. Sokuji підтримує обидва варіанти: у налаштуваннях під провайдером PalabraAI є перемикач Platform API Key / App Client ID/Secret. Якщо ви починаєте з нуля, використовуйте Platform — це режим за замовчуванням у Sokuji та новіша консоль Palabra. Якщо у вас уже є облікові дані App, вони продовжують працювати — просто перемкніться в режим App.
1Виберіть вид облікових даних
Вирішіть, яку консоль ви використовуватимете, і виконайте лише один із двох наступних кроків. Уперше в Palabra? Зареєструйтеся на platform.palabra.ai/register і використовуйте Platform API Key (крок 2). Уже маєте Client ID і Client Secret з App? Переходьте одразу до кроку 3 — створювати нічого нового не потрібно.
2Platform: створіть API Key
Перейдіть на platform.palabra.ai/api-keys та увійдіть. Створіть новий ключ і дайте йому описову назву, наприклад «Sokuji». Ключ показується лише один раз, одразу після створення — негайно скопіюйте його та збережіть у надійному місці; після оновлення сторінки переглянути його знову неможливо. Якщо ви його втратили, видаліть ключ і створіть новий.
3App: створіть ключ і скопіюйте обидва значення
Перейдіть на app.palabra.ai/dev/api-keys та увійдіть. Ця сторінка розташована на вкладці Developer застосунку Palabra, у розділі Developer Tools → API Keys. Натисніть + Create API Key, дайте йому описову назву, наприклад «Sokuji», потім відкрийте ключ і скопіюйте обидва значення: Client ID та Client Secret. Client Secret можна скопіювати лише один раз, під час створення; після цього він приховується і не може бути відновлений. Якщо ви його втратили, видаліть ключ і створіть новий. Кожен обліковий запис може мати до 3 ключів.


4Перевірте баланс кредитів
PalabraAI — платний сервіс: якщо на обліковому записі закінчаться кредити, сеанс не запуститься або перерветься на середині. Перед початком перевірте баланс кредитів і стан безкоштовного пробного періоду в тій консолі, де ви створили облікові дані (в App це показано в лівому нижньому куті бічної панелі та на сторінці Usage), і переконайтеся, що кредити ще є.
5Налаштуйте в Sokuji
Відкрийте Sokuji та перейдіть до панелі налаштувань. Виберіть «PalabraAI» як провайдера ШІ. За допомогою перемикача над полями облікових даних виберіть режим, що відповідає консолі, у якій ви створили облікові дані: Platform API Key показує одне поле API Key — вставте туди ключ; App Client ID/Secret показує два поля — вставте Client ID та Client Secret у відповідні поля (переконайтеся, що вони не переплутані). В обох випадках перевірте, що немає зайвих пробілів, натисніть Перевірити, щоб підтвердити, що облікові дані прийнято, потім виберіть налаштування голосу (default_low або default_high), налаштуйте мови-джерела та цільові мови, та натисніть «Зберегти налаштування».
6Протестуйте налаштування
Розпочніть сеанс перекладу, щоб переконатися, що все працює. Натисніть кнопку «Розпочати сеанс», говоріть у мікрофон, і ви повинні почути перекладений аудіовихід з мінімальною затримкою.
Специфічні функції PalabraAI
Технологія WebRTC
PalabraAI використовує WebRTC для потокової передачі з наднизькою затримкою, що ідеально підходить для розмов у реальному часі. Сервіс автоматично обробляє:
- Стиснення та передачу аудіо
- Оптимізацію мережі
- Автоматичне налаштування якості
- Придушення ехо та зменшення шуму
Підтримка мов
PalabraAI підтримує широкі мовні комбінації:
- Понад 60 мов-джерел, включаючи основні світові мови та регіональні варіанти
- Понад 40 цільових мов з регіональною специфікою (наприклад, мексиканська іспанська vs. іспанська)
- Оптимізовано для найбільш запитуваних мовних пар
Автоматична обробка
На відміну від інших провайдерів, PalabraAI автоматично обробляє більшу частину аудіо:
- Не потрібне ручне налаштування виявлення черговості
- Автоматична оптимізація якості звуку
- Вбудоване зменшення шуму
- Адаптивна потокова передача залежно від мережевих умов
Усунення несправностей
Поширені проблеми
Помилка автентифікації: Переконайтеся, що перемикач режиму в Sokuji відповідає консолі, з якої отримано облікові дані: ключ з platform.palabra.ai вставляється в поле API Key у режимі Platform API Key; пара Client ID + Client Secret з app.palabra.ai — у режимі App Client ID/Secret. Sokuji ніколи не пробує інший режим автоматично, тому ключ Platform, вставлений у поле Client ID (або навпаки), завжди призведе до помилки. Якщо у вас більше немає ключа або Client Secret, видаліть його в консолі та створіть новий.
Сеанс не запускається: Спочатку перевірте баланс кредитів та стан безкоштовного пробного періоду того облікового запису, у якому ви створили облікові дані — вичерпаний баланс є найпоширенішою причиною. Потім переконайтеся, що ваш файервол/мережа дозволяє WebRTC-підключення.
Проблеми з підключенням: PalabraAI використовує WebRTC, тому переконайтеся, що ваш файервол/мережа дозволяє WebRTC-підключення.
Проблеми з якістю звуку: Спробуйте перемикатися між голосовими налаштуваннями default_low та default_high залежно від мережевих умов.
Мовна пара не працює: Переконайтеся, що вибрана комбінація мови-джерела та цільової мови підтримується.
Мережеві вимоги
- Стабільне інтернет-з'єднання (мінімум 1 Мбіт/с завантаження/вивантаження)
- Низька мережева затримка (бажано менше 100 мс)
- Мережева конфігурація, сумісна з WebRTC
- За можливості уникайте VPN для мінімальної затримки
Потрібна додаткова допомога? Ознайомтеся з документацією PalabraAI або відвідайте наш репозиторій GitHub для отримання підтримки.