Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opret og konfigurér en API-nøgle

Lektion 2 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Hvorfor oprette nøgler via API’et
  2. Oprettelses-endpoint
  3. Komplet eksempel med curl
  4. Anbefalede ACL-strategier
  5. Tilgængelige ACL-endpoints
  6. Vigtige pointer

Hvorfor oprette nøgler via API’et

At oprette en nøgle manuelt tager tredive sekunder – hvilket er præcis grunden til, at du har brug for automatisering. Fordi det går hurtigt, gør du det uden at tænke: ingen navngivningskonvention, ingen hastighedsbegrænsninger, bare et jokertegn for at “komme hurtigt videre”. Seks måneder senere ved ingen, hvad hver nøgle gør.

Brug af API’et tvinger dig til at navngive, afgrænse og sætte loft for hver nøgle, fordi disse er scriptparametre. Konsistens holder op med at være en disciplin, du skal opretholde, og bliver i stedet en egenskab ved koden. Du kan automatisere oprettelse af nøgler til dine miljøer (dev, staging, produktion), anvende granulare ACL’er og definere hastighedsbegrænsninger – alt sammen direkte i dine deployment-scripts eller infrastrukturværktøjer.

Oprettelses-endpoint

For at oprette en API-nøgle sender du en POST-forespørgsel til følgende endpoint:

POST /auth/teams/{teamId}/api-keys

Forespørgselsbody

{
  "name": "ma-cle-production",
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.20-0309-reasoning"
  ],
  "qps": 10,
  "qpm": 100,
  "tpm": 1000000,
  "expireTime": "2026-12-31T23:59:59Z"
}

Detaljerede parametre

name (påkrævet): en læsbar identifikator for din nøgle. Vælg et beskrivende navn, der angiver anvendelsen (prod-backend, staging-chatbot, dev-john). Dette navn vises i konsollen og i brugsloggene.

acls (påkrævet): listen over tilladelser, der gives til denne nøgle. To formater er tilgængelige:

  • api-key:endpoint:[endpoint] – begrænser de tilgængelige endpoints (chat, embed, image, models, sample, tokenize, documents)
  • api-key:model:[model] – begrænser de modeller, der kan bruges (grok-4.20-0309-reasoning, grok-4.3 osv.)

Tegnet * fungerer som et jokertegn: api-key:endpoint:* autoriserer alle endpoints, api-key:model:* alle modeller. Reserver dette til lokal udvikling. I produktion betyder et jokertegn, at en kompromitteret nøgle giver adgang til alt, hvad dit team kan gøre – inklusive de dyreste modeller, som din applikation måske aldrig bruger.

qps (valgfri): queries per second – maksimalt antal forespørgsler per sekund.

qpm (valgfri): queries per minute – maksimalt antal forespørgsler per minut.

tpm (valgfri): tokens per minute – maksimalt antal tokens behandlet per minut.

expireTime (valgfri): udløbsdato i ISO 8601-format. Nøglen deaktiveres automatisk på denne dato.

Komplet eksempel med curl

curl -X POST "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-backend-v2",
    "acls": [
      "api-key:endpoint:chat",
      "api-key:endpoint:embed",
      "api-key:model:grok-4.20-0309-reasoning",
      "api-key:model:grok-4.3"
    ],
    "qps": 20,
    "qpm": 500,
    "tpm": 2000000,
    "expireTime": "2027-06-30T23:59:59Z"
  }'

Svaret indeholder den hemmelige nøgle, som aldrig vises igen. Denne regel har en praktisk konsekvens, du skal forudse, før du kører scriptet, ikke bagefter: Hvis du opretter nøgler i en løkke, skal lagringen ske i samme bevægelse. En nøgle, der mistes mellem oprettelse og registrering, kan ikke gendannes – du skal slette den og starte forfra. Skriv den til en hvælving (Vault, AWS Secrets Manager) snarere end til din terminals standard-output, hvor den ender i din historik.

Anbefalede ACL-strategier

Udviklingsnøgle (bred)

{
  "acls": ["api-key:endpoint:*", "api-key:model:*"],
  "qps": 5,
  "qpm": 50
}

Ideel til lokal udvikling: Adgangen er bred, fordi du ikke på forhånd ved, hvad du vil prøve, men hastighedsbegrænsningerne holdes lave. Dette er det rigtige kompromis – en uendelig løkke skrevet ved en fejl en fredag aften vil koste få cents i stedet for et par hundrede euro.

Produktionsnøgle (begrænset)

{
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.20-0309-reasoning"
  ],
  "qps": 50,
  "qpm": 2000,
  "tpm": 5000000
}

I produktion vender reglen sig: Start med det, applikationen faktisk gør, og autorisér kun dét. Spørgsmålet, du altid skal stille, når du skriver ACL’en, er det samme: Hvis denne nøgle lækker i morgen, hvad kan en tredjepart så gøre med den? En nøgle begrænset til chat på en enkelt model og capped til ti forespørgsler per sekund giver et kort svar.

Midlertidig nøgle (udløbende)

{
  "acls": ["api-key:endpoint:*", "api-key:model:*"],
  "expireTime": "2026-04-10T00:00:00Z"
}

Automatisk udløb løser det problem, som ingen håndterer: nøgler, folk glemmer at slette. Et POC, en demonstration, en midlertidig konsulent – i alle disse tilfælde garanterer expireTime, at adgangen slår sig selv fra. Dette er den eneste pålidelige måde at opretholde et rent lager på, fordi det ikke afhænger af nogens hukommelse.

Tilgængelige ACL-endpoints

For at se de endpoints, du kan bruge i ACL’er, skal du konsultere:

GET /auth/teams/{teamId}/endpoints

De tilgængelige endpoints er: chat, embed, image, models, sample, tokenize, documents. Denne liste kan udvikle sig over tid, så tjek den regelmæssigt.

Vigtige pointer

  • Nøgleoprettelse sker via POST /auth/teams/{teamId}/api-keys
  • ACL’er følger formatet api-key:endpoint:[navn] eller api-key:model:[navn]
  • Jokertegnet * giver fuld adgang til alle endpoints eller modeller
  • Den hemmelige nøgle vises kun én gang ved oprettelsen – gem den straks
  • Definer altid hastighedsbegrænsninger (qps, qpm, tpm) tilpasset brugen
  • Brug expireTime til midlertidige nøgler