Generuoti API raktą
Šiame puslapyje
Programinė prieiga prie „Grok“
API raktas yra autentifikavimo žetonas, leidžiantis tavo programoms bendrauti su „Grok“ modeliais. Be jo jokia užklausa nepraeis. Šioje pamokoje parodysime, kaip sukurti ir valdyti savo raktus „xAI“ konsolėje.
Atidaryk konsolę
Eik į console.x.ai ir prisijunk paskyra, kurią sukūrei ankstesniame žingsnyje. Konsolė yra tavo pagrindinis skydelis raktams valdyti, naudojimui stebėti ir atsiskaitymui nustatyti.
Šoniniame meniu atidaryk API Keys (pilnas kelias: console.x.ai/team/default/api-keys).
Sukurk savo pirmąjį raktą
Spausk Create API Key. Kiekvienam raktui gali suteikti aprašomąjį pavadinimą, kad būtų aišku, kam jis skirtas:
dev-local– kūrimo aplinkaiprod-backend– gamybos serveriuitest-ci– nuolatinės integracijos vamzdynui
Raktas rodomas tik vieną kartą jo kūrimo metu. Nedelsdamas jį nukopijuok ir saugiai paslėpk (slaptažodžių tvarkyklėje arba paslapčių saugykloje). Jei raktą prarasi, teks generuoti naują.
Rakto formatas
„xAI“ API raktai prasideda priešdėliu xai-, po kurio eina alfanumerinė eilutė. Šis priešdėlis padeda greitai atpažinti raktus konfigūracijos failuose ir aptikti juos, jei jie netyčia patektų į源代码 (source code).
Valdymo geriausios praktikos
Vienas raktas vienai aplinkai
Kiekvienam kontekstui sukurk atskirus raktus. Jei raktas nutekėtų, galėtum jį panaikinti nepaveikdamas kitų aplinkų.
Reguliarus atnaujinimas
Periodiškai atnaujink savo raktus, ypač gamybos aplinkose. Procedūra paprasta: sukurk naują raktą, atnaujink savo programą, tada ištrink senąjį.
Patikrink prieš dalindamasis
Prieš bendrindamas projektą, įsitikink, kad jokiame源代码 (source code) nėra įterptų raktų. Naudok .env failus, kurių neįtrauki į versijų valdymą (pridėk .env į savo .gitignore).
Su raktais susijęs atsiskaitymas
Kiekviena API užklausa, atlikta naudojant raktą, yra skaičiuojama ir apmokestinama. „xAI“ siūlo du režimus:
- Išankstiniai kreditai: perkate kreditus iš anksto, o už užklausas jie nurašomi iškart
- Mėnesinis atsiskaitymas: už naudojimą, viršijantį turimus kreditus, apmokama mėnesio pabaigoje
Patikrink savo atsiskaitymo informaciją konsolėje prieš pradėdamas naudoti API, nes sąskaitų faktūrų negalima keisti atgaline data.
Iškart išbandyk raktą
Skirk trisdešimt sekundžių raktui patvirtinti, prieš įtraukdamas jį į projektą. Paprasčiausias testas – paprašyti modelių sąrašo:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
JSON atsakas su modelių sąrašu patvirtina, kad raktas aktyvus ir atsiskaitymas tvarkoje. 401 klaida reiškia, kad raktas nukopijuotas neteisingai; 403 klaida rodo leidimų arba kreditų problemą. Išsiaiškinus tai čia, šaltinyje, sutaupysi laiko derinimui vėliau, viduryje savo programos kodo.
Svarbiausi punktai
- Raktus kuri adresu console.x.ai/team/default/api-keys
- Jie prasideda
xai-ir rodomi tik vieną kartą - Kiekvienai aplinkai sukurk atskirą raktą ir saugok juos paslapčių saugykloje
- Prieš bet kokią API užklausą patikrink savo atsiskaitymo režimą
- Kiekvieną naują raktą patikrink iškviesdamas
/v1/models, prieš jį integruodamas