Een API-sleutel genereren
Op deze pagina
Programmatische toegang tot Grok
De API-sleutel is het authenticatietoken waarmee uw applicaties kunnen communiceren met de Grok-modellen. Zonder deze sleutel wordt geen enkel verzoek verwerkt. In deze les leert u hoe u uw sleutels maakt en beheert in de xAI-console.
De console openen
Ga naar console.x.ai en meld u aan met het account dat u in de vorige stap heeft aangemaakt. De console is uw centrale dashboard voor het beheren van sleutels, het monitoren van gebruik en het instellen van facturatie.
Open in het zijmenu API Keys (volledig pad: console.x.ai/team/default/api-keys).
Uw eerste sleutel maken
Klik op Create API Key. U kunt elke sleutel een beschrijvende naam geven om het doel ervan te identificeren:
dev-localvoor uw ontwikkelomgevingprod-backendvoor uw productieservertest-civoor uw continuous integration-pipeline
De sleutel wordt slechts één keer getoond, op het moment van aanmaken. Kopieer deze onmiddellijk en bewaar hem op een veilige plek (een wachtwoordbeheerder of een secrets vault). Als u een sleutel kwijtraakt, moet u een nieuwe genereren.
Sleutelformaat
xAI API-sleutels beginnen met het voorvoegsel xai-, gevolgd door een alfanumerieke reeks. Dit voorvoegsel helpt u om ze snel te herkennen in uw configuratiebestanden en om ze op te sporen als ze per ongeluk in broncode terechtkomen.
Best practices voor beheer
Één sleutel per omgeving
Maak voor elke context aparte sleutels aan. Als een sleutel uitlekt, kunt u deze intrekken zonder uw andere omgevingen te beïnvloeden.
Regelmatige rotatie
Vernieuw uw sleutels periodiek, vooral voor productieomgevingen. De procedure is eenvoudig: maak een nieuwe sleutel aan, werk uw applicatie bij en verwijder vervolgens de oude.
Controleren voordat u deelt
Voordat u een project deelt, controleert u of er geen sleutel hard-coded in de broncode staat. Gebruik .env-bestanden die buiten versiebeheer worden gehouden (voeg .env toe aan uw .gitignore).
Facturatie gekoppeld aan sleutels
Elke API-oproep die met een sleutel wordt gedaan, wordt geteld en gefactureerd. xAI biedt twee modi:
- Prepaid credits: u koopt credits vooraf en oproepen worden direct afgetrokken
- Maandelijkse facturatie: gebruik dat uw credits overschrijdt, wordt aan het einde van de maand gefactureerd
Controleer uw facturatiegegevens in de console voordat u de API gaat gebruiken, omdat facturen niet met terugwerkende kracht kunnen worden gewijzigd.
Test de sleutel direct
Neem dertig seconden de tijd om de sleutel te valideren voordat u deze in een project verwerkt. De eenvoudigste test vraagt de lijst met modellen op:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Een JSON-antwoord met een lijst van modellen bevestigt dat de sleutel actief is en dat de facturatie in orde is. Een 401-fout betekent dat de sleutel onjuist is gekopieerd; een 403-fout wijst op een probleem met machtigingen of credits. Door dit hier, aan de bron, te diagnosticeren, bespaart u zich later een debugsessie midden in uw applicatiecode.
Belangrijkste punten
- U maakt sleutels aan op console.x.ai/team/default/api-keys
- Ze beginnen met
xai-en worden slechts één keer getoond - Maak één sleutel per omgeving aan en bewaar ze in een secrets vault
- Controleer uw facturatiemodus voordat u API-oproepen doet
- Valideer elke nieuwe sleutel met een oproep naar
/v1/modelsvoordat u deze integreert