Erste Schritte

Diese Anleitung führt eine Einrichtung in drei Schritten von null bis zur ersten funktionierenden Anfrage und zeigt anschließend, wie Sie prüfen, ob alles funktioniert hat.

Bevor Sie beginnen

• Sie benötigen die Rolle Organisation Administrator. Model Router steht nur Organisation Administrator in Einrichtungen mit Technology Stack zur Verfügung.
• Wählen Sie die Einrichtung, die Sie konfigurieren möchten, über die Einrichtungsauswahl in der Hauptsymbolleiste des Performance Hub aus.
• Hinterlegen Sie eine Zahlungskarte für die Einrichtung, oder halten Sie eine bereit. Aufladungen belasten Ihre gespeicherte Zahlungskarte; ist keine hinterlegt, zeigt die Seite „Balance & Top-up“ "No card on file." mit einem Link Add payment details an.

Schritt 1 – Model Router aktivieren

Öffnen Sie Model Router über das Hauptmenü (in der Gruppe AI Modules & Agents). Wurde das Modul für diese Einrichtung noch nicht aktiviert, sehen Sie die Seite Welcome to Model Router:

"Ermöglichen Sie Ihrem Unternehmen den Prepaid-Zugriff auf einen Katalog führender AI-Modelle über einen einzigen, OpenAI-kompatiblen Endpunkt. Ihre Performance Hub AI Agents verbinden sich automatisch, und Sie können API-Keys erstellen, um dieselbe Modelle in Ihre eigene Software einzubinden – mit Spend Limits und vollständiger Transparenz über die Nutzung."

Abbildung 1: Die Seite Welcome to Model Router, die eine Einrichtung sieht, bevor das Modul aktiviert ist

Die Seite hat drei Schaltflächen: Enable Model Router, Read the documentation (öffnet diese Dokumentation) und Explore first without enabling. Darunter wird die Einrichtung in drei Schritten beschrieben:

Jeder Schritt hat außerdem einen Link Learn more.

Klicken Sie auf Enable Model Router (oder Enable module), um das Modul einzuschalten.

Die Einrichtungs-Checkliste

Nachdem Sie das Modul aktiviert haben, wird oben in Model Router ein Banner mit einer Einrichtungs-Checkliste angezeigt, bis die Einrichtung abgeschlossen ist. Es trägt den Titel Finish setting up Model Router und zeigt eine Zeitschätzung (z. B. ~3 min left), wie viele Schritte abgeschlossen sind (z. B. 2 of 3 complete), sowie eine Schaltfläche Resume, die die vollständige Checkliste aufklappt. Jeder Schritt hat Review (bzw. Review again) und Learn more; mit Collapse klappen Sie sie wieder zu. Ist nur noch ein Schritt übrig, lautet der aufgeklappte Untertitel "Just one step to go before AI requests start flowing. Steps can be done in any order."

Abbildung 2: Das Banner mit der Einrichtungs-Checkliste, das bis zum Abschluss der Einrichtung angezeigt wird

Die erforderlichen Schritte sind Add a billing card, Top up your balance und Connect an agent or create an API key. Optionale Schritte – Set spend limits, Turn on auto top-up und Verify your first request – können mit Skip for now ausgeblendet werden.

Schritt 2 – Zum ersten Mal Guthaben aufladen

Gehen Sie zu Budgets & Limits → Balance & Top-up.

Abbildung 3: Die Karte Top up balance (Vorgabebeträge, Betrag, gespeicherte Karte) und die Karte Auto top-up

1. Wählen Sie in der Karte Top up balance einen Vorgabebetrag ($25, $50, $100, $250, $500, $1000) oder geben Sie einen Betrag ein. "Minimum top-up is $10."
2. Prüfen Sie die unter dem Betrag angezeigte gespeicherte Karte (z. B. "Amex ending 0005 · exp 06/29"). Verwenden Sie Edit payment details, falls sie aktualisiert werden muss.
3. Klicken Sie auf Top up $–.––. Bei Erfolg sehen Sie "Top-up successful. Your balance has been credited." Aufladungen erscheinen sofort im Guthaben.

Empfohlen: Schalten Sie in der Karte Auto top-up die Option Enable auto top-up ein, legen Sie When balance is below und Top up by (ebenfalls mindestens $10) fest und klicken Sie auf Änderungen speichern. Ihre Karte wird dann automatisch belastet, sobald das Guthaben unter den Schwellenwert fällt, sodass die Inferenz nie unerwartet stoppt. Einzelheiten finden Sie unter Budgets und Aufladungen.

Schritt 3 – Ihre erste Anfrage senden

Wählen Sie den Weg, der auf Sie zutrifft:

Wenn Sie KI-Agenten oder Workflows haben

Es ist nichts zu konfigurieren – mit dieser Einrichtung gekoppelte KI-Agent-Geräte verbinden sich automatisch, und auch Workflows können sich verbinden. Öffnen Sie Settings (Zahnrad) → Service Access & API Keys und prüfen Sie, ob Ihr Agent unter Connected Services mit dem Status Online angezeigt wird. Siehe Connected Services.

Wenn Sie Ihre eigene Software verbinden

1. Öffnen Sie Settings (Zahnrad) → Service Access & API Keys und klicken Sie auf Create key. Kopieren Sie den Geheimschlüssel aus dem Dialog "Copy your API key" – "This is the only time the full key is shown. Store it somewhere safe."
2. Verwenden Sie die Base URL und die Beispielanfrage aus der Karte Connecting to the API auf derselben Seite. Ein minimaler Test:

curl https://app.performancehub.co/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'

Beispiele für Python und TypeScript finden Sie unter Ihre Anwendung verbinden.

Schritt 4 – Prüfen

Öffnen Sie die Registerkarte Logs. Ihre Testanfrage sollte innerhalb weniger Augenblicke mit Modell, Token-Anzahl, Kosten, Geschwindigkeit und dem Status success erscheinen. Ist das nicht der Fall, siehe Fehlerbehebung.

Empfohlene nächste Schritte

• Ausgabenlimits festlegen – Budgets & Limits → Spend Limits. Ein Monatslimit ist ein sinnvolles Sicherheitsnetz; siehe Budgets und Aufladungen.
• Den Modellkatalog prüfen – Einstellungen → Models. Alle Modelle sind standardmäßig aktiviert; mit den Schnellvorgaben können Sie die Auswahl eingrenzen, wenn Sie Präferenzen bei Anbietern oder Budget haben. Siehe Models.
• Guardrails in Betracht ziehen – Einstellungen → Guardrails für PII-Maskierung, Schwärzung von Geheimnissen und Schutz vor Prompt-Injection. Standardmäßig ist keine davon aktiviert. Siehe Guardrails.