Połączenie OpenAI, Anthropic, Gemini, Mistral, Groq lub OpenRouter z Xcellerate AIG

Po połączeniu OpenAI, Anthropic, Google Gemini, Mistral, Groq lub OpenRouter z Xcellerate AIG Twój zespół ma jeden kontrolowany punkt dostępu do hostowanych modeli AI. Aplikacje wywołują AIG własnym kluczem wirtualnym i nigdy nie widzą klucza dostawcy. Ten poradnik jest dla administratora, który konfiguruje AIG dla MSP, małej firmy lub firmy usługowej.

W skrócie

• Konfiguracja jest taka sama dla wszystkich sześciu dostawców: wybierz typ, nadaj nazwę, wklej jeden klucz API.
• Nowy provider startuje jako wyłączony, więc najpierw testujesz go jednym małym zapytaniem.
• Po włączeniu synchronizujesz katalog modeli i wydajesz klucz wirtualny każdej aplikacji.

Zanim zaczniesz

• Konto u dostawcy i standardowy klucz API: klucz OpenAI, klucz z konsoli Anthropic, klucz Google AI Studio (Gemini API) albo klucz Mistral, Groq lub OpenRouter.
• Rola Admin w AIG lub własna rola z uprawnieniem do tworzenia i edycji providerów.
• Wychodzący ruch HTTPS z serwera AIG do dostawcy. Domyślne adresy to 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. Jeśli ruch musi iść przez proxy, ustaw je w General settings → Network egress (ustawienia ogólne → wychodzący ruch sieciowy).
• Adresy callback ani webhooki nie są potrzebne.

Konfiguracja providera

1. Uruchom kreator

W menu bocznym przejdź do Connect → Providers (Połącz → Providerzy) i kliknij Connect a provider (połącz providera). Jeśli wolisz pełny formularz, wybierz Set up manually (konfiguracja ręczna) lub Add provider (dodaj providera).

2. Wybierz dostawcę i nadaj nazwę

W polu Provider type (typ providera) wybierz OpenAI, Anthropic, Google Gemini, Mistral, Groq lub OpenRouter. Nadaj Display name (nazwa wyświetlana), którą wszyscy rozpoznają, np. „OpenAI produkcja”. Zostaw Base URL (bazowy URL) puste, aby użyć domyślnego adresu dostawcy.

3. Wklej klucz API

Wklej klucz w pole API key (klucz API). AIG zapisuje providera jako wyłączonego, więc ruch jeszcze do niego nie trafia.

4. Przetestuj

Przyciskiem Try it (wypróbuj) wyślij jedno małe, prawdziwe zapytanie. Kosztuje kilka tokenów. Możesz też wybrać Continue anyway (kontynuuj mimo to); provider pozostaje wtedy wyłączony. Później Test connection (testuj połączenie) wykonuje ten sam test.

5. Włącz, zsynchronizuj i wydaj klucz

Kliknij Enable provider (włącz providera). Następnie wczytaj katalog modeli przez Models → Sync (Modele → Synchronizuj) i utwórz klucz dla aplikacji w Governance → Virtual keys → New virtual key (nowy klucz wirtualny).

Opcjonalnie: więcej kluczy, węższy zakres

• Przez Add key (dodaj klucz) dodasz kilka kluczy dostawcy do jednego providera; każdemu nadaj Weight (waga), aby rozłożyć ruch.
• Ogranicz klucz do wybranych modeli przez Allowed models (dozwolone modele).
• W What this provider serves (co obsługuje ten provider) zaznacz tylko to, czego potrzebujesz.

Co dzieje się po połączeniu

Aplikacje wskazują model jako <nazwa-providera>/<model>, np. openai/gpt-4o-mini, albo samą nazwą modelu, którą AIG odnajduje w katalogu. AIG tłumaczy każde zapytanie na format dostawcy. Dzięki temu jedno zapytanie w stylu OpenAI może trafić do OpenAI, Anthropic lub Gemini.

Synchronizacja katalogu pobiera nazwy modeli, okna kontekstu i ceny z opublikowanej karty danych, według harmonogramu (najczęściej raz na godzinę) lub na żądanie. Wynegocjowane ceny możesz nadpisać.

Co obsługuje każdy typ:

• OpenAI: czat, embeddings, obrazy, mowa, transkrypcja, rerank
• Anthropic: czat
• Google Gemini: czat, embeddings
• Mistral: czat, embeddings, transkrypcja
• Groq: czat, transkrypcja, mowa
• OpenRouter: czat, embeddings, obrazy

Dobrze wiedzieć

• Max retries (maksymalna liczba ponowień) domyślnie wynosi 0. Włączaj ponowienia świadomie.
• Przy kilku kluczach AIG automatycznie je rotuje. Odrzucony klucz dostaje status Dead lub Suspect; klucz, który trafił na limit, pokazuje Cooling down i wraca sam.
• Wyłączenie providera zatrzymuje ruch od następnego zapytania, a klucze zostają. Usunięcie providera usuwa też jego klucze.
• Strumieniowane zapytania w stylu OpenAI są wyceniane tylko wtedy, gdy wywołujący wyśle stream_options: {"include_usage": true}.
• Klucze API są tylko do zapisu: po zapisaniu widzisz jedynie zamaskowaną podpowiedź, np. sk-…4f2a, a klucze dostawcy nigdy nie pojawiają się w komunikatach o błędach.
• Bez licencji AIG działa w trybie darmowym: 5 kluczy wirtualnych, po 5 zapytań na klucz dziennie. Licencja znosi ten limit.

Rozwiązywanie problemów

• „No enabled key to test with.” Dodaj klucz lub włącz istniejący i przetestuj ponownie.
• „No model to try. Sync the catalog first…” Uruchom Models → Sync i spróbuj ponownie.
• <model> did not answer (<ms> ms): <message> Komunikat pochodzi od dostawcy. Sprawdź klucz i czy Twoje konto ma dostęp do tego modelu.
• No healthy API key is available for provider '…' (503) lub Every API key configured for '…' failed for this request. (502): sprawdź status kluczy (Healthy, Dead, Cooling down, Suspect), popraw klucz i kliknij Clear health flags (wyczyść znaczniki stanu). No enabled provider is configured for '…' (400) oznacza, że żaden włączony provider nie pasuje do tej nazwy.

Porozmawiaj z nami o AIG

Chcesz zobaczyć, jak AIG pasuje do Twojego MSP lub firmy usługowej? Porozmawiaj z nami o AIG. Więcej o wszystkich dostawcach w jednym katalogu i kluczach wirtualnych.