Połącz aplikacje i narzędzia z Xcellerate AIG: API zgodne z OpenAI, Claude Code, Cursor i Copilot Studio

Każda aplikacja, SDK czy narzędzie, które rozmawia z OpenAI, może rozmawiać z Xcellerate AIG, gdy zmienisz dwa ustawienia: base URL i klucz API. Zespoły korzystające z SDK Anthropic, Google lub AWS Bedrock mogą je zachować, bo AIG odpowiada w formacie każdego dostawcy. Każde wywołanie dostaje wtedy budżety, rate limits, guardrails, routing, failover i wpis w logu.

TL;DR

• Utwórz jeden klucz wirtualny na aplikację, zespół lub agenta.
• Skieruj klienta na właściwy base URL: /v1, /anthropic, /genai, /bedrock lub /v1/mcp.
• Sprawdź pierwsze wywołanie w logach. Prawdziwe klucze dostawców nigdy nie trafiają do klientów.

Zanim zaczniesz

• Administrator z uprawnieniem do tworzenia kluczy wirtualnych (uprawnienie Governance).
• Co najmniej jeden włączony dostawca w AIG i zsynchronizowany katalog modeli.
• Dostęp sieciowy z aplikacji do https://<your-gateway> (TLS, port 443).
• Klient, w którym można ustawić własny base URL lub endpoint.

Połącz aplikację lub narzędzie

1. Utwórz klucz wirtualny

Przejdź do Govern → Governance → Virtual keys (Zarządzanie → Governance → Klucze wirtualne) i kliknij New virtual key (Nowy klucz wirtualny). W razie potrzeby ogranicz dostawców i modele oraz ustaw budżet, rate limit, ważność (od 30 minut do bezterminowej), narzędzia MCP i politykę IP. Od razu skopiuj token sk-xc-…: jest pokazywany tylko raz.

2. Skieruj klienta na AIG

• Claude Code: ustaw ANTHROPIC_BASE_URL na https://<your-gateway>/anthropic i ANTHROPIC_AUTH_TOKEN na swój klucz wirtualny.
• Microsoft Copilot Studio: endpoint https://<your-gateway>/v1/mcp, uwierzytelnianie „API key”, nagłówek Authorization: Bearer <virtual key>. Narzędzia pojawiają się jako mcp__<server>__<tool>.

3. Użyj nazwy modelu z AIG

Weź nazwę z Connect → Models (Połączenia → Modele), na przykład openai/gpt-4o-mini, albo krótką nazwę, jeśli jest unikalna.

4. Sprawdź pierwsze wywołanie

Wyślij żądanie i otwórz Traffic → Logs (Ruch → Logi). Filtr „Arrived as” pokazuje, którym punktem wejścia przyszło wywołanie. Każda odpowiedź zawiera ID żądania w nagłówku x-xc-request-id.

Co się dzieje po połączeniu

• GET /v1/models pokazuje tylko modele, które ten klucz może wywołać.
• /v1 obejmuje chat completions (także streaming), embeddings, generowanie obrazów, syntezę mowy, transkrypcję, rerank, models, responses, files, batches, feedback i MCP.
• Routing może obsłużyć żądanie przez innego dostawcę niż wskazany; odpowiedź zachowuje format wywołującego.
• Opcjonalne nagłówki: x-xc-tags (np. prod,checkout) do przypisywania kosztów, x-xc-agent-name i x-xc-agent-run-id do osi czasu agentów, X-Request-Id i traceparent do łączenia z Twoimi logami i trace'ami.

Dobrze wiedzieć

• Żądania ze streamingiem wymagają stream_options: {"include_usage": true}, aby można je było wycenić.
• Klienci Bedrock SDK muszą zastąpić nagłówek SigV4 Authorization kluczem wirtualnym, np. za pomocą event hooka boto3. Obsługiwane są tylko invoke i invoke-with-response-stream.
• Wywołania funkcji Gemini przychodzą w całości, nie strumieniowo. Strumienie Anthropic podają tokeny wejściowe na końcu.
• Endpointy beta dostawców nie są modelowane. Istnieje pass-through dla klucza i dostawcy, ale domyślnie jest wyłączony.
• W trybie bezpłatnym: do 5 aktywnych kluczy wirtualnych i 5 żądań na klucz dziennie.
• Interfejsy czatu, takie jak Open WebUI, nie mają osobnej integracji. Podłącz je jak każdego klienta zgodnego z OpenAI.

Rozwiązywanie problemów

• 401 „Incorrect API key provided.” lub „This API key has expired.”: klucz jest nieznany, unieważniony lub wygasł.
• 403 „This API key is not permitted to use the model '…'.”: model jest poza zakresem klucza. Blokada guardrail również zwraca 403.
• 404 „The model '…' does not exist or you do not have access to it.”: sprawdź nazwę na ekranie Models.
• 402 lub 429: budżet lub rate limit klucza się wyczerpał; odczekaj czas z retry-after.

Błędy na /anthropic i /genai wracają w formacie błędów danego dostawcy.

Dowiedz się więcej o jednym API dla wszystkich modeli, kluczach wirtualnych i logach żądań.

Chcesz, aby narzędzia AI Twojego zespołu działały przez jedną kontrolowaną bramę? Porozmawiaj z nami o AIG.