Генериране на API ключ
На тази страница
Програмен достъп до Grok
API ключът е токенът за удостоверяване, който позволява на Вашите приложения да комуникират с моделите на Grok. Без него никоя заявка няма да бъде изпълнена. В този урок ще Ви преведем през процеса на създаване и управление на Вашите ключове в конзолата на xAI.
Отваряне на конзолата
Отидете на console.x.ai и влезте с акаунта, който създадохте в предишната стъпка. Конзолата е Вашето централно табло за управление на ключовете, мониторинг на използването и настройка на фактурирането.
В страничното меню отворете API Keys (пълен път: console.x.ai/team/default/api-keys).
Създаване на първия Ви ключ
Кликнете върху Create API Key. Можете да дадете описателно име на всеки ключ, за да идентифицирате предназначението му:
dev-localза Вашата среда за разработкаprod-backendза Вашия производствен сървърtest-ciза Вашия pipeline за непрекъсната интеграция
Ключът се показва само веднъж при създаването му. Копирайте го незабавно и го съхранете на сигурно място (мениджър на пароли или хранилище за тайни). Ако загубите ключ, ще трябва да генерирате нов.
Формат на ключа
API ключовете на xAI започват с префикса xai-, последван от алфанумеричен низ. Този префикс Ви помага бързо да ги откривате във конфигурационните си файлове и да ги засичате, ако случайно бъдат изложени в изходния код.
Най-добри практики за управление
Един ключ за всяка среда
Създавайте отделни ключове за всеки контекст. Ако даден ключ бъде компрометиран, можете да го анулирате, без да засегнете другите си среди.
Редовна ротация
Подновявайте ключовете си периодично, особено за производствените среди. Процедурата е проста: създайте нов ключ, актуализирайте приложението си и след това изтрийте стария.
Проверка преди споделяне
Преди да споделите проект, уверете се, че в изходния код няма вградени (hard-coded) ключове. Използвайте .env файлове, които се изключват от системата за контрол на версиите (добавете .env към Вашия .gitignore).
Фактуриране, свързано с ключовете
Всяко API обаждане, направено с даден ключ, се брои и таксува. xAI предлага два режима:
- Предплатени кредити: закупувате кредити предварително и обажданията се приспадат незабавно
- Месечно фактуриране: използването над рамката на Вашите кредити се фактурира в края на месеца
Проверете информацията за фактуриране в конзолата преди да започнете да използвате API, тъй като фактурите не могат да бъдат променяни със задна дата.
Тествайте ключа веднага
Отделете тридесет секунди, за да валидирате ключа, преди да го вградите в проект. Най-простият тест изисква списък с моделите:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
JSON отговор, изброяващ моделите, потвърждава, че ключът е активен и фактурирането е наред. Грешка 401 означава, че ключът е копиран неправилно; грешка 403 сочи проблем с разрешенията или кредитите. Диагностицирането на проблема тук, в източника, Ви спестява сесия за отстраняване на грешки по-късно посред кода на приложението.
Ключови изводи
- Създавате ключове на console.x.ai/team/default/api-keys
- Те започват с
xai-и се показват само веднъж - Създавайте по един ключ за всяка среда и ги съхранявайте в хранилище за тайни
- Проверете режима си на фактуриране преди всяко API обаждане
- Валидирайте всеки нов ключ с обаждане до
/v1/models, преди да го интегрирате