Премини към основното съдържание
Български— Изберете език
Меню

Management API: Управление на ключове и фактуриране

Урок 12 от 14 Обновен 28 юли 2026 г. Средно
На тази страница
  1. Управление на акаунта без конзолата
  2. Създаване и ротация на ключове
  3. Проследяване и контрол на фактурирането
  4. Мониторинг на потреблението с правилната гранулярност
  5. Ключови изводи

Управление на акаунта без конзолата

Management API на xAI е REST интерфейс, посветен на управлението на Вашия Enterprise акаунт. Докато Inference API (api.x.ai) извиква модели, Management API (management-api.x.ai) администрира Вашите ресурси. Разликата може да изглежда незначителна. Не е. Всичко, което иначе би изисквало някой да отвори уеб конзолата и да кликне, тук става автоматизируемо – проследимо, възпроизводимо и интегрируемо с инструментите, които екипите Ви вече използват.

Създаване и ротация на ключове

Създаването на ключове чрез API Ви позволява да автоматизирате предоставянето на достъп за ново приложение или среда:

curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "cle-production-chatbot",
    "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
    "qps": 10,
    "qpm": 100,
    "tpm": 1000000,
    "expireTime": "2026-12-31T23:59:59Z"
  }'

Параметрите в тази заявка дефинират изцяло обхвата на ключа:

  • name: Идентификатор, четим от човек, за ключа
  • acls: Списък с разрешения (оторизирани крайни точки и модели)
  • qps/qpm/tpm: Лимити на скоростта за секунда, за минута и токени за минута
  • expireTime: Дата на автоматично изтичане на валидността

Задаването на expireTime при създаването е навикът, който Ви спестява най-много проблеми в дългосрочен план: ключ, издаден за тримесечен пилотен проект, изтича сам, вместо да остане безсрочно във конфигурационен файл, който никой вече не чете.

Редовната ротация на ключове следва същата хигиена на сигурността. Специализираният крайна точка генерира нов секретен ключ и анулира стария:

curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Предупреждение: старият секретен ключ се анулира незабавно и окончателно. Подгответе се да разположите новата стойност във Вашия мениджър на тайни преди изпълнението на командата, никога след това. Три крайни точки само за четене допълват набора: GET /auth/teams/{teamId}/api-keys изброява всички ключове за екипа, GET /auth/api-keys/{apiKeyId}/propagation проверява дали ключът е разпространен във всички възли, а GET /auth/teams/{teamId}/models изброява достъпните модели с техните цени. Втората е тази, която консултирате веднага след ротация, когато дадено приложение все още връща грешки при удостоверяване и не сте сигурни дали става въпрос за бъг в приложението или просто за забавяне при разпространението.

Проследяване и контрол на фактурирането

Извличането на информация за фактурирането използва специализирана крайна точка:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Получавате история на фактурите с филтриране по период, ето например за март 2026 г.:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Всяка фактура има статус измежду PENDING, PAID, FAILED и WILL_NEVER_BE_CHARGED. Откриването на статус FAILED във Вашия мониторинг е много по-добре, отколкото да научите за инцидента чрез прекъсване на услугата в понеделник сутрин.

За да предотвратите надхвърляне на бюджета, конфигурирайте месечен лимит:

curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 5000}'

Ако работите с предплащане, проверете баланса по същия начин:

# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Имайте предвид, че кредитите при предплащане са невъзстановими, освен ако законът не изисква друго. Оразмерявайте покупките си въз основа на потреблението, наблюдавано в продължение на няколко седмици, а не на оптимистични прогнози за растеж.

Мониторинг на потреблението с правилната гранулярност

Крайната точка за аналитика Ви позволява да проследявате използването с фина гранулярност:

curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-03-01 00:00:00",
        "endTime": "2026-04-01 00:00:00",
        "timezone": "UTC"
      },
      "timeUnit": "DAY",
      "values": [{"name": "tokens", "aggregation": "SUM"}],
      "groupBy": ["model"]
    }
  }'

Тази заявка връща дневното потребление на токени, разбито по модели, за месец март. Чрез промяна на timeUnit преминавате от месечен изглед към изглед за минута: възможните стойности са MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR и MINUTE. Агрегациите отиват далеч отвъд простите суми, включвайки SUM, AVG, MIN, MAX, P50, P90, P99 и COUNT. Перцентилите характеризират натоварването ефективно, защото средните стойности изглаждат точно онези пикове, които определят капацитета, от който всъщност се нуждаете.

След това Management API заема своето място във Вашия набор от инструменти. Предоставяте ключове от Terraform или Pulumi точно както база данни, Вашият CI/CD конвейер създава ефемерни ключове за тестови среди и ги изтрива в края на изпълнението, скриптовете за мониторинг подават сигнали преди достигане на лимита за разходи, а Вашите вътрешни табла показват потреблението, без човек да трябва да експортира CSV всеки понеделник.

Ключови изводи

  • Management API на management-api.x.ai управлява ключове, фактуриране и метрики
  • Ротацията на ключове окончателно анулира стария секретен ключ
  • Лимитите за разходи предпазват от надхвърляне на бюджета
  • Анализът на използването предлага гранулярност от минута до месец
  • Интегрирайте Management API във Вашите инфраструктурни инструменти, за да автоматизирате администрирането