Головна/Рецепти/Підключити провайдера ENУКРРУС API-довідник (ReDoc) ↗

Підключити провайдера

Як додати рушій і заповнити його таблицю мов без сотні ручних правок.

Мета: підключають новий рушій перекладу. Він має з'явитися тут, щоб викликачі могли резолвити для нього коди.

1. Спершу додайте його в provider_credentials

Коди провайдерів спільні для двох сервісів. Додайте вендора й провайдера в config/providers.yaml у provider_credentials, потім використайте той самий код тут. Викликач, що резолвить кред там і код мови тут, не повинен перекладати між двома схемами іменування.

Якщо поки що це лише консольний провайдер — усе одно додайте тут і лишіть in_credentials_catalog як false; так зроблено для yandex_translate і pangea_mt.

2. Створіть

Admin → Providers. Код, назва, вендор, категорія (mt / ai / custom_mt) і політика фолбеку.

Починайте з base_language. Це те, на чому їдуть усі інші, і воно ніколи не відмовляє парі, яку ви не перевіряли.

3. Додайте аліаси

Усе інше, що можуть надсилати викликачі: коротка назва (newmt) і будь-який легасі-ідентифікатор, якщо це заміна чогось. Будь-який рядок тут резолвиться в провайдера.

4. Заповніть таблицю мов

З нуля — рідко. Більшість рушіїв говорять набором кодів, близьким до вже налаштованого:

Provider settings → Copy mappings from another provider → оберіть найближчого → Copy.

З кого починати:

Рушій це… Копіювати з
LLM, що приймає будь-який тег BCP-47 openai_api
Великий MT API зі стандартними тегами google_translate
MT API китайського ринку baidu_translate або tencent_transmart
Клієнтський fine-tune вендор, чий API його обслуговує

Скопійовані рядки позначаються як copied:<source> у полі джерела, тож згодом їх видно окремо від перевірених вручну.

5. Виправте відмінності

Matrix → Show → Pinned only покаже те, що ви щойно скопіювали. Пройдіть це проти документації провайдера й виправте, що відрізняється. Потім Show → Derived only — для пар, які нічим не покриті.

Спершу пройдіть мови, які ви справді продаєте.

6. Перевірте

Tools → Resolve tester, або:

curl ".../v1/providers/newmt_api/languages?effective=true" | jq '.total'
curl ".../v1/resolve?provider=newmt_api&language=pt-BR"

Затягування гайок пізніше

Коли ви зафіксуєте, які пари справді падають, розгляньте strict — але спершу прочитайте Fallback Policies. Лічильник derived у таблиці покриття — це рівно та кількість пар, які почнуть відповідати supported: false.

Далі