Підключення OpenAI, Anthropic, Gemini, Mistral, Groq або OpenRouter до Xcellerate AIG

Підключивши OpenAI, Anthropic, Google Gemini, Mistral, Groq або OpenRouter до Xcellerate AIG, ваша команда отримує одну керовану точку доступу до хмарних моделей ШІ. Ваші застосунки звертаються до AIG із власним віртуальним ключем і ніколи не бачать ключа постачальника. Цей посібник для адміністратора, який налаштовує AIG для MSP, малого бізнесу чи сервісної компанії.

Коротко

• Налаштування однакове для всіх шести постачальників: оберіть тип, дайте назву, вставте один API-ключ.
• Новий провайдер створюється вимкненим, тож спершу ви перевіряєте його одним невеликим запитом.
• Після увімкнення синхронізуйте каталог моделей і видайте віртуальний ключ кожному застосунку.

Перш ніж почати

• Обліковий запис у постачальника та стандартний API-ключ: ключ OpenAI, ключ із консолі Anthropic, ключ Google AI Studio (Gemini API) або ключ Mistral, Groq чи OpenRouter.
• Роль Admin в AIG або власна роль із правом створювати та редагувати провайдерів.
• Вихідний HTTPS-трафік від сервера AIG до постачальника. Типові адреси: api.openai.com/v1, api.anthropic.com/v1, generativelanguage.googleapis.com/v1beta, api.mistral.ai/v1, api.groq.com/openai/v1, openrouter.ai/api/v1. Якщо трафік має йти через проксі, задайте його в General settings → Network egress (Загальні налаштування → вихідний мережевий трафік).
• Callback-адреси чи вебхуки не потрібні.

Налаштування провайдера

1. Запустіть майстер

У бічному меню відкрийте Connect → Providers (Підключення → Провайдери) і натисніть Connect a provider (Підключити провайдера). Якщо зручніше працювати з повною формою, оберіть Set up manually (налаштувати вручну) або Add provider (додати провайдера).

2. Оберіть постачальника й назвіть його

У полі Provider type (тип провайдера) оберіть OpenAI, Anthropic, Google Gemini, Mistral, Groq або OpenRouter. Задайте Display name (відображувана назва), зрозумілу всім, наприклад «OpenAI продакшн». Залиште Base URL (базова URL-адреса) порожнім, щоб використовувати типову адресу постачальника.

3. Вставте API-ключ

Вставте ключ у поле API key (API-ключ). AIG зберігає провайдера вимкненим, тож трафік до нього ще не йде.

4. Перевірте

Кнопкою Try it (спробувати) надішліть один невеликий реальний запит. Він коштує кілька токенів. Можна також обрати Continue anyway (все одно продовжити); тоді провайдер залишається вимкненим. Пізніше Test connection (перевірити з'єднання) виконує ту саму перевірку.

5. Увімкніть, синхронізуйте й видайте ключ

Натисніть Enable provider (увімкнути провайдера). Потім завантажте каталог моделей через Models → Sync (Моделі → Синхронізувати) і створіть ключ для застосунку в Governance → Virtual keys → New virtual key (новий віртуальний ключ).

Необов'язково: кілька ключів, вужчий доступ

• Через Add key (додати ключ) можна додати кілька ключів постачальника до одного провайдера і дати кожному Weight (вага), щоб розподіляти трафік.
• Обмежте ключ певними моделями через Allowed models (дозволені моделі).
• У What this provider serves (що надає цей провайдер) позначте лише потрібне.

Що відбувається після підключення

Застосунки звертаються до моделі як <назва-провайдера>/<модель>, наприклад openai/gpt-4o-mini, або за короткою назвою моделі, яку AIG знаходить у каталозі. AIG перекладає кожен запит у формат постачальника. Тож один запит у стилі OpenAI може дійти до OpenAI, Anthropic або Gemini.

Синхронізація каталогу отримує назви моделей, контекстні вікна й ціни з опублікованого довідкового листа, за розкладом (не частіше ніж раз на годину) або на вимогу. Якщо у вас є узгоджені ціни, їх можна перевизначити.

Що надає кожен тип:

• OpenAI: чат, embeddings, зображення, мовлення, транскрипція, rerank
• Anthropic: чат
• Google Gemini: чат, embeddings
• Mistral: чат, embeddings, транскрипція
• Groq: чат, транскрипція, мовлення
• OpenRouter: чат, embeddings, зображення

Корисно знати

• Max retries (максимум повторних спроб) за замовчуванням дорівнює 0. Вмикайте повтори свідомо.
• Якщо ключів кілька, AIG чергує їх автоматично. Відхилений ключ отримує статус Dead або Suspect; ключ, що вперся в ліміт, показує Cooling down і повертається сам.
• Вимкнення провайдера зупиняє трафік з наступного запиту, ключі зберігаються. Видалення провайдера видаляє і його ключі.
• Потокові запити в стилі OpenAI тарифікуються лише тоді, коли клієнт надсилає stream_options: {"include_usage": true}.
• API-ключі доступні лише для запису: після збереження ви бачите тільки замасковану підказку на кшталт sk-…4f2a, а ключі постачальника ніколи не з'являються в повідомленнях про помилки.
• Без ліцензії AIG працює в безкоштовному режимі: 5 віртуальних ключів, по 5 запитів на ключ на день. Ліцензія знімає це обмеження.

Усунення проблем

• «No enabled key to test with.» Додайте ключ або увімкніть наявний і перевірте ще раз.
• «No model to try. Sync the catalog first…» Виконайте Models → Sync і спробуйте знову.
• <model> did not answer (<ms> ms): <message> Повідомлення надходить від постачальника. Перевірте ключ і чи має ваш обліковий запис доступ до цієї моделі.
• No healthy API key is available for provider '…' (503) або Every API key configured for '…' failed for this request. (502): перевірте статус ключів (Healthy, Dead, Cooling down, Suspect), виправте ключ і натисніть Clear health flags (скинути позначки стану). No enabled provider is configured for '…' (400) означає, що немає увімкненого провайдера з такою назвою.

Поговоріть з нами про AIG

Хочете побачити, як AIG вписується у ваш MSP чи сервісний бізнес? Поговоріть з нами про AIG. Докладніше про усіх постачальників в одному каталозі та віртуальні ключі.