Начало работыАутентификация

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

Для всех эндпоинтов, кроме GET /v1/models, нужен API-ключ. Передайте его в одном из этих заголовков. Оба работают на всех эндпоинтах, поэтому используйте тот, который отправляет ваш клиент:

  • Authorization: Bearer $YOUR_KEY: его отправляют OpenAI SDK и большинство инструментов.
  • x-api-key: $YOUR_KEY: его отправляют Anthropic SDK.

Обозначения: $API_BASE — это https://api.abliteratedllm.dev/v1, $API_ORIGIN — https://api.abliteratedllm.dev, а $YOUR_KEY — ваш API-ключ.

bash
# OpenAI style
curl $API_BASE/balance -H "Authorization: Bearer $YOUR_KEY"

# Anthropic style
curl $API_BASE/balance -H "x-api-key: $YOUR_KEY"

API-ключи

Создавайте, переименовывайте, изменяйте и отзывайте ключи в разделе API-ключи. Там же видно, когда каждый ключ использовался в последний раз (с точностью до нескольких минут) и сколько он потратил.

  • Ключ состоит из sk- и следующих за ним 48 букв и цифр.
  • Он показывается один раз, при создании. Мы храним только его хеш с секретным ключом, поэтому показать ключ повторно не можем. В личном кабинете ключи различаются по первым 10 символам.
  • У аккаунта может быть до 20 активных ключей. Чтобы освободить место для нового, отзовите один из них.
  • Создавать ключи можно не чаще 30 попыток в час на аккаунт. Последующие попытки получают 429 rate_limit_exceeded с заголовком Retry-After.
  • Отзыв ключа вступает в силу в течение 30 секунд.
  • У ключа может быть срок действия. Ключ перестаёт работать в 00:00 UTC в указанную дату, и запросы с ним получают 401 invalid_api_key с сообщением This API key expired on 2026-12-31 00:00 UTC. Пока ключ не отозван, истёкшему ключу можно назначить более позднюю дату, чтобы снова им пользоваться.
  • Песочница использует собственный ключ: им управляем мы, и в списке он не отображается.

Лимиты расходов

Для каждого ключа можно задать дневной лимит, месячный лимит и общий бюджет в любом сочетании. Сутки и месяцы считаются по UTC; общий бюджет учитывает расходы ключа с момента появления общих бюджетов (для более старых ключей добавляются только последние 30 дней использования до этого момента). Перед тем как запрос будет передан дальше, его максимальная возможная стоимость (резервирование, описанное на странице Лимиты запросов и пробный доступ) прибавляется к тому, что ключ уже потратил за период. Если сумма превышает лимит, запрос завершается ошибкой 402 key_spend_cap_reached и ничего не списывается; в сообщении указано, какой лимит сработал (дневной, месячный или общий). С помощью лимитов удобно выдать скрипту или коллеге ключ с фиксированным бюджетом. GET /v1/balance показывает остаток по каждому из них.

Номер аккаунта и API-ключи не взаимозаменяемы

16-значный номер аккаунта нужен для входа на сайт. Как API-ключ он не работает, а API-ключом нельзя войти на сайт. Храните и то и другое в секрете: тот, у кого есть номер аккаунта, управляет аккаунтом и средствами на его балансе.

Ошибки

Статус аккаунта проверяется в запросе раньше всего остального.

СтатусКодЗначение
401invalid_api_keyКлюч не передан либо имеет неверный формат, неизвестен, отозван или истёк.
403account_suspendedАккаунт приостановлен. Все его ключи отклоняются, пока приостановка не будет снята.
403account_bannedАккаунт заблокирован. Его ключи отозваны, а оставшиеся средства аннулируются.

Полный список — на странице Ошибки.

ID запросов

Каждый ответ, включая ошибки, содержит заголовок x-request-id. Указывайте его, когда обращаетесь в поддержку или сообщаете о проблеме. По нему мы находим метаданные запроса (время, ключ, модель, количество токенов, стоимость, статус и задержку), которые храним 30 дней. Мы не храним промпты и ответы модели (см. политику конфиденциальности), поэтому ID запроса — единственный способ указать на конкретный запрос.