Generera en API-nyckel
På denna sida
Programmatisk åtkomst till Grok
API-nyckeln är autentiseringstoken som låter dina applikationer kommunicera med Grok-modellerna. Utan den går ingen begäran igenom. I denna lektion går vi igenom hur du skapar och hanterar dina nycklar i xAI-konsolen.
Öppna konsolen
Gå till console.x.ai och logga in med kontot du skapade i föregående steg. Konsolen är din centrala instrumentpanel för att hantera nycklar, övervaka användning och konfigurera fakturering.
Öppna API Keys i sidomenyn (fullständig sökväg: console.x.ai/team/default/api-keys).
Skapa din första nyckel
Klicka på Create API Key. Du kan ge varje nyckel ett beskrivande namn för att identifiera dess syfte:
dev-localför din utvecklingsmiljöprod-backendför din produktionsservertest-ciför din pipeline för kontinuerlig integration
Nyckeln visas endast en gång, vid skapandet. Kopiera den omedelbart och lagra den på en säker plats (t.ex. i en lösenordshanterare eller ett valv för hemligheter). Om du tappar bort en nyckel måste du generera en ny.
Nyckelformat
xAI:s API-nycklar börjar med prefixet xai- följt av en alfanumerisk sträng. Prefixet hjälper dig att snabbt hitta dem i dina konfigurationsfiler och upptäcka dem om de av misstag exponeras i källkoden.
Bästa praxis för hantering
En nyckel per miljö
Skapa separata nycklar för varje kontext. Om en nyckel läcker kan du återkalla den utan att påverka dina andra miljöer.
Regelbunden rotation
Förnya dina nycklar periodvis, särskilt för produktionsmiljöer. Förfarandet är enkelt: skapa en ny nyckel, uppdatera din applikation och radera sedan den gamla.
Kontrollera innan delning
Innan du delar ett projekt, se till att ingen nyckel är hårdkodad i källkoden. Använd .env-filer som hålls utanför versionskontrollen (lägg till .env i din .gitignore).
Fakturering kopplad till nycklar
Varje API-anrop som görs med en nyckel räknas och faktureras. xAI erbjuder två lägen:
- Förbetalda krediter: du köper krediter i förväg och anrop dras av omedelbart
- Månatlig fakturering: användning utöver dina krediter faktureras i slutet av månaden
Kontrollera din faktureringsinformation i konsolen innan du börjar använda API:t, eftersom fakturor inte kan ändras i efterhand.
Testa nyckeln direkt
Ta trettio sekunder på dig att validera nyckeln innan du bäddar in den i ett projekt. Det enklaste testet begär en lista över modeller:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Ett JSON-svar som listar modellerna bekräftar att nyckeln är aktiv och att faktureringen fungerar som den ska. Ett 401-fel betyder att nyckeln kopierades felaktigt; ett 403-fel pekar på ett problem med behörigheter eller krediter. Att diagnostisera detta här, vid källan, sparar dig en felsökningssession mitt i din applikationskod senare.
Viktiga punkter
- Du skapar nycklar på console.x.ai/team/default/api-keys
- De börjar med
xai-och visas endast en gång - Skapa en nyckel per miljö och lagra dem i ett valv för hemligheter
- Kontrollera ditt faktureringsläge innan du gör några API-anrop
- Validera varje ny nyckel med ett anrop till
/v1/modelsinnan du integrerar den