OpenAI, Anthropic, Gemini, Mistral, Groq oder OpenRouter mit Xcellerate AIG verbinden

Wenn Sie OpenAI, Anthropic, Google Gemini, Mistral, Groq oder OpenRouter mit Xcellerate AIG verbinden, erhält Ihr Team einen zentralen, kontrollierten Zugang zu gehosteten KI-Modellen. Ihre Anwendungen rufen AIG mit einem eigenen virtuellen Schlüssel auf und bekommen den Schlüssel des Anbieters nie zu sehen. Diese Anleitung richtet sich an Admins, die AIG für ein MSP, KMU oder Dienstleistungsunternehmen einrichten.

Kurz gesagt

• Die Einrichtung ist für alle sechs Anbieter gleich: Typ wählen, Namen vergeben, einen API-Schlüssel einfügen.
• Ein neuer Provider startet deaktiviert, damit Sie ihn zuerst mit einer kleinen Anfrage testen.
• Nach der Aktivierung synchronisieren Sie den Modellkatalog und geben pro Anwendung einen virtuellen Schlüssel aus.

Bevor Sie beginnen

• Ein Konto beim Anbieter und einen normalen API-Schlüssel: einen OpenAI-Schlüssel, einen Schlüssel aus der Anthropic-Konsole, einen Google-AI-Studio-Schlüssel (Gemini API) oder einen Schlüssel von Mistral, Groq oder OpenRouter.
• Die Rolle Admin in AIG oder eine eigene Rolle mit dem Recht, Provider anzulegen und zu bearbeiten.
• Ausgehendes HTTPS vom AIG-Host zum Anbieter. Die Standardadressen sind 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. Muss der Verkehr über einen Proxy laufen, stellen Sie ihn unter General settings → Network egress (Allgemeine Einstellungen → ausgehender Netzwerkverkehr) ein.
• Callback-URLs oder Webhooks sind nicht nötig.

Provider einrichten

1. Assistenten starten

Gehen Sie in der Seitenleiste zu Connect → Providers (Verbinden → Provider) und klicken Sie auf Connect a provider (Provider verbinden). Wenn Sie das vollständige Formular bevorzugen, wählen Sie Set up manually (manuell einrichten) oder Add provider (Provider hinzufügen).

2. Anbieter wählen und benennen

Wählen Sie unter Provider type (Providertyp) OpenAI, Anthropic, Google Gemini, Mistral, Groq oder OpenRouter. Vergeben Sie einen Display name (Anzeigename), den alle erkennen, zum Beispiel „OpenAI Produktion“. Lassen Sie Base URL (Basis-URL) leer, um die Standardadresse des Anbieters zu verwenden.

3. API-Schlüssel einfügen

Fügen Sie den Schlüssel in das Feld API key (API-Schlüssel) ein. AIG speichert den Provider deaktiviert, es fließt also noch kein Verkehr.

4. Testen

Senden Sie mit Try it (ausprobieren) eine kleine, echte Anfrage. Sie kostet ein paar Tokens. Sie können auch Continue anyway (trotzdem fortfahren) wählen; der Provider bleibt dann deaktiviert. Später führt Test connection (Verbindung testen) dieselbe Prüfung aus.

5. Aktivieren, synchronisieren, Schlüssel ausgeben

Klicken Sie auf Enable provider (Provider aktivieren). Laden Sie dann den Modellkatalog über Models → Sync (Modelle → Synchronisieren) und legen Sie unter Governance → Virtual keys → New virtual key (neuer virtueller Schlüssel) einen Schlüssel für Ihre Anwendung an.

Optional: mehrere Schlüssel, engerer Umfang

• Mit Add key (Schlüssel hinzufügen) hinterlegen Sie mehrere Anbieterschlüssel an einem Provider und geben jedem ein Weight (Gewicht), um den Verkehr zu verteilen.
• Beschränken Sie einen Schlüssel mit Allowed models (erlaubte Modelle) auf bestimmte Modelle.
• Haken Sie unter What this provider serves (was dieser Provider liefert) nur an, was Sie brauchen.

Was nach dem Verbinden passiert

Ihre Anwendungen sprechen ein Modell als <provider-name>/<modell> an, zum Beispiel openai/gpt-4o-mini, oder über einen reinen Modellnamen, den AIG über den Katalog auflöst. AIG übersetzt jede Anfrage in das Format des Anbieters. So kann eine Anfrage im OpenAI-Stil OpenAI, Anthropic oder Gemini erreichen.

Die Katalogsynchronisierung holt Modellnamen, Kontextfenster und Preise aus einem veröffentlichten Datenblatt, nach Zeitplan (höchstens einmal pro Stunde) oder auf Abruf. Ausgehandelte Preise können Sie überschreiben.

Was jeder Typ liefert:

• OpenAI: Chat, Embeddings, Bilder, Sprachausgabe, Transkription, Rerank
• Anthropic: Chat
• Google Gemini: Chat, Embeddings
• Mistral: Chat, Embeddings, Transkription
• Groq: Chat, Transkription, Sprachausgabe
• OpenRouter: Chat, Embeddings, Bilder

Gut zu wissen

• Max retries (maximale Wiederholungen) steht standardmäßig auf 0. Schalten Sie Wiederholungen bewusst ein.
• Bei mehreren Schlüsseln wechselt AIG automatisch. Ein abgelehnter Schlüssel wird als Dead oder Suspect markiert; ein Schlüssel im Rate-Limit steht auf Cooling down und kommt von selbst zurück.
• Das Deaktivieren eines Providers stoppt den Verkehr ab der nächsten Anfrage; die Schlüssel bleiben erhalten. Das Löschen eines Providers löscht auch seine Schlüssel.
• Gestreamte Anfragen im OpenAI-Stil werden nur bepreist, wenn der Aufrufer stream_options: {"include_usage": true} mitsendet.
• API-Schlüssel sind nur schreibbar: Nach dem Speichern sehen Sie nur einen maskierten Hinweis wie sk-…4f2a, und Anbieterschlüssel erscheinen nie in Fehlermeldungen.
• Ohne Lizenz läuft AIG im kostenlosen Modus: 5 virtuelle Schlüssel mit je 5 Anfragen pro Tag. Eine Lizenz hebt diese Grenze auf.

Fehlerbehebung

• „No enabled key to test with.“ Fügen Sie einen Schlüssel hinzu oder aktivieren Sie den vorhandenen und testen Sie erneut.
• „No model to try. Sync the catalog first…“ Führen Sie Models → Sync aus und versuchen Sie es erneut.
• <model> did not answer (<ms> ms): <message> Die Meldung stammt vom Anbieter. Prüfen Sie den Schlüssel und ob Ihr Konto Zugriff auf dieses Modell hat.
• No healthy API key is available for provider '…' (503) oder Every API key configured for '…' failed for this request. (502): Prüfen Sie den Schlüsselstatus (Healthy, Dead, Cooling down, Suspect), korrigieren Sie den Schlüssel und klicken Sie auf Clear health flags (Statusmarkierungen löschen). No enabled provider is configured for '…' (400) bedeutet, dass kein aktivierter Provider zu diesem Namen passt.

Sprechen Sie mit uns über AIG

Sie möchten sehen, wie AIG zu Ihrem MSP oder Dienstleistungsunternehmen passt? Sprechen Sie mit uns über AIG. Mehr dazu: alle Anbieter in einem Katalog und virtuelle Schlüssel.