GeraikitaGeraikita AI
МенюАутентификация

Аутентификация

Каждый запрос аутентифицируется вашим API-ключом, начинающимся с gk-. Стоимость списывается с баланса GeraiPoints аккаунта, которому принадлежит ключ.

Передача API-ключа

Передавайте ключ в одном из следующих заголовков. Оба работают на всех платных эндпоинтах.

ЗаголовокФорматПримечание
AuthorizationBearer gk-…По умолчанию у клиентов формата OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…По умолчанию у клиентов формата Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01SDK Anthropic отправляет автоматически; добавляйте при прямом вызове /v1/messages.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Если ключ не передан, неверен или отозван, сервер отвечает 401 с type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Создание и отзыв ключей

  1. Откройте Dashboard и выберите Создать API-ключ.
  2. Дайте имя, описывающее назначение (например, laptop-kantor или server-produksi), и при необходимости выберите разрешённые модели.
  3. Скопируйте ключ и сохраните в надёжном месте. Чтобы отозвать ключ, нажмите Отозвать в списке ключей — запросы с этим ключом сразу будут отклоняться.
Полный ключ показывается только один раз при создании, повторно его не посмотреть. Не более 20 активных ключей на аккаунт — отзовите старый ключ, чтобы создать новый.

Ограничение ключа определёнными моделями

Каждый ключ можно ограничить определённым списком моделей (allowlist). Пустой список означает, что разрешены все модели. Запросы к моделям вне списка получают 403 permission_error, а GET /v1/models с этим ключом показывает только разрешённые модели. Используйте это для ключей, которые выдаёте приложениям или команде, чтобы держать расходы под контролем.

Типы ключей

КлючНазначениеBase URL
gk-Платный API — списание из GeraiPoints. Создаётся в Dashboard.https://ai.geraikita.com/v1
gk- (bansos)Бесплатный тариф — дневная квота, отдельный эндпоинт. См. Бесплатный тариф (Bansos). Не работает на платных эндпоинтах, и наоборот.https://ai.geraikita.com/v1/claude
gkr-Реселлерская программа — управляется на странице Reseller.—

Безопасность ключей

  • Не размещайте ключ во фронтенд-коде (браузер, мобильные приложения). Вызывайте API со своего сервера.
  • Храните ключи в переменных окружения или менеджере секретов и никогда не коммитьте их в репозиторий.
  • Используйте отдельный ключ для каждого приложения или устройства — так проще отслеживать расход и можно отозвать один ключ, не затрагивая остальные.
  • Подозреваете утечку ключа? Сразу отзовите его в Dashboard и создайте новый.