Aan de slag

Deze handleiding brengt een faciliteit in drie stappen van niets naar een eerste werkende aanvraag en laat daarna zien hoe je controleert of het is gelukt.

Voordat je begint

• Je moet Organisation Administrator zijn. Model Router is alleen beschikbaar voor Organisation Administrators, bij faciliteiten met Technology Stack.
• Selecteer de faciliteit die je wilt configureren met de faciliteitkiezer in de hoofdwerkbalk van Performance Hub.
• Zorg dat er een betaalkaart voor de faciliteit is opgeslagen, of houd er een bij de hand om toe te voegen. Aanvullingen worden van je opgeslagen betaalkaart afgeschreven; als er geen kaart is opgeslagen, toont de pagina Balance & Top-up "No card on file." met een link Add payment details.

Stap 1: Model Router inschakelen

Open Model Router vanuit het hoofdmenu (in de groep AI Modules & Agents). Als de module nog niet voor deze faciliteit is ingeschakeld, zie je de pagina Welcome to Model Router:

"Geef je bedrijf prepaid toegang tot een catalogus met toonaangevende AI-modellen via één enkel, met OpenAI compatibel eindpunt. Je Performance Hub AI Agents maken automatisch verbinding en je kunt API keys aanmaken om dezelfde modellen te integreren in je eigen software — met spend limits en volledige zichtbaarheid op het verbruik."

Afbeelding 1: De pagina Welcome to Model Router die een faciliteit ziet voordat de module is ingeschakeld

De pagina heeft drie knoppen: Enable Model Router, Read the documentation (opent deze documentatie) en Explore first without enabling. Daaronder beschrijven drie stappen de inrichting:

Elke stap heeft ook een link Learn more.

Klik op Enable Model Router (of Enable module) om de module in te schakelen.

De checklist voor de inrichting

Nadat je de module hebt ingeschakeld, verschijnt bovenaan Model Router een banner met een checklist totdat de inrichting is voltooid. De banner heet Finish setting up Model Router en toont een tijdsinschatting (bijvoorbeeld ~3 min left), hoeveel stappen zijn voltooid (bijvoorbeeld 2 of 3 complete) en een knop Resume die de volledige checklist uitvouwt. Elke stap heeft Review (of Review again) en Learn more; met Collapse vouw je de lijst weer in. Wanneer er nog één stap over is, luidt de ondertitel in de uitgevouwen weergave "Just one step to go before AI requests start flowing. Steps can be done in any order."

Afbeelding 2: De banner met de checklist, getoond totdat de inrichting is voltooid

De verplichte stappen zijn Add a billing card, Top up your balance en Connect an agent or create an API key. Optionele stappen (Set spend limits, Turn on auto top-up en Verify your first request) kun je wegklikken met Skip for now.

Stap 2: Je eerste aanvulling uitvoeren

Ga naar Budgets & Limits → Balance & Top-up.

Afbeelding 3: De kaart Top up balance (voorinstellingen, bedrag, opgeslagen kaart) en de kaart Auto top-up

1. Kies op de kaart Top up balance een voorinstelling ($25, $50, $100, $250, $500, $1000) of typ een bedrag. "Minimum top-up is $10."
2. Controleer de opgeslagen kaart die onder het bedrag wordt getoond (bijvoorbeeld "Amex ending 0005 · exp 06/29"). Gebruik Edit payment details als de gegevens moeten worden bijgewerkt.
3. Klik op Top up $–.––. Als het lukt, zie je "Top-up successful. Your balance has been credited." Aanvullingen verschijnen direct in het saldo.

Aanbevolen: zet op de kaart Auto top-up de schakelaar Enable auto top-up aan, stel When balance is below en Top up by in (ook minimaal $10) en klik op Save changes. Je kaart wordt dan automatisch belast zodra het saldo onder de drempel zakt, zodat inferentie nooit onverwacht stopt. Zie Budgetten en aanvullingen voor meer informatie.

Stap 3: Je eerste aanvraag versturen

Kies de route die op jou van toepassing is:

Als je AI Agents of Workflows hebt

Er valt niets te configureren: AI-agent-apparaten die aan deze faciliteit zijn gekoppeld, maken automatisch verbinding, en ook Workflows kunnen verbinding maken. Open Settings (tandwiel) → Service Access & API Keys en controleer of je agent onder Connected Services verschijnt met de status Online. Zie Connected Services.

Als je je eigen software verbindt

1. Open Settings (tandwiel) → Service Access & API Keys en klik op Create key. Kopieer het geheim uit het dialoogvenster "Copy your API key": "This is the only time the full key is shown. Store it somewhere safe."
2. Gebruik de Base URL en de voorbeeldaanvraag op de kaart Connecting to the API op dezelfde pagina. Een minimale 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"}]}'

Zie Je applicatie verbinden voor voorbeelden in Python en TypeScript.

Stap 4: Controleren

Open het tabblad Logs. Je testaanvraag hoort binnen enkele ogenblikken te verschijnen, met het model, het aantal tokens, de kosten, de snelheid en de status success. Als dat niet zo is, zie Probleemoplossing.

Aanbevolen volgende stappen

• Stel uitgavenlimieten in: Budgets & Limits → Spend Limits. Een maandlimiet is een verstandig vangnet; zie Budgetten en aanvullingen.
• Bekijk de modelcatalogus: Settings → Models. Alle modellen zijn standaard ingeschakeld; gebruik de snelle voorinstellingen om de set te verkleinen als je voorkeuren hebt voor aanbieders of budget. Zie Models.
• Overweeg guardrails: Settings → Guardrails voor het maskeren van persoonsgegevens, het verwijderen van geheimen en bescherming tegen promptinjectie. Standaard is er geen enkele ingeschakeld. Zie Guardrails.