Source: https://ailoot.ai/docs/ru/keys/
Canonical: https://ailoot.ai/docs/ru/keys/
Language: ru

[Начало](https://ailoot.ai/docs/ru/) 

# Ключи и адрес API

[Markdown](https://ailoot.ai/docs/ru/keys/index.md)

Где взять ключ, какой адрес указывать в разных SDK и как передавать ключ.

## [](https://ailoot.ai/docs/ru/keys/#key)Ключ API

Ключ создаётся в кабинете на [ailoot.ai](https://ailoot.ai) после [регистрации](https://ailoot.ai/register). Он выглядит как `sk-…`. Можно завести несколько ключей: отдельно для рабочего компьютера, сервера и каждого приложения — так проще отозвать один, не трогая остальные.

У ключа можно задать общий лимит трат, срок действия, белый и чёрный списки IP-адресов и лимиты трат за окна 5 часов, 1 день и 7 дней. Если ограничение сработает, придёт понятная ошибка: `api_key_quota_exhausted` (исчерпан общий лимит), `usage_limit_reached` (исчерпано окно трат ключа — подождите, пока окно обновится, или поднимите лимит), `api_key_expired` или `permission_denied` (например, запрос не с разрешённого IP).

Не публикуйте ключ в коде, репозиториях и скриншотах. Храните его в переменной окружения или менеджере секретов. Если ключ утёк — удалите его в кабинете и создайте новый.

## [](https://ailoot.ai/docs/ru/keys/#base-url)Адрес API

Главное правило: для OpenAI-совместимых клиентов адрес с `/v1`, для Anthropic и Gemini — без него.

| Клиент | Базовый адрес | Куда уходит запрос |
| --- | --- | --- |
| OpenAI SDK и совместимые | `https://api.ailoot.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings` |
| Anthropic SDK, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| Google GenAI SDK, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| Клиент просит полный адрес | `https://api.ailoot.ai/v1/chat/completions` | как указано |

Получили 404 сразу после настройки? Почти всегда дело в адресе: лишний или недостающий `/v1`, двойной слеш или `/chat/completions` там, где клиент добавляет его сам.

## [](https://ailoot.ai/docs/ru/keys/#auth)Как передать ключ

Ailoot принимает ключ в любом из трёх заголовков — какой отправляет ваш SDK, такой и подойдёт:

| Заголовок | Кто так отправляет |
| --- | --- |
| `Authorization: Bearer sk-…` | OpenAI SDK, большинство клиентов |
| `x-api-key: sk-…` | Anthropic SDK, Claude Code с ANTHROPIC\_API\_KEY |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

На путях `/v1/…` ключ в адресе (`?key=` или `?api_key=`) не принимается: запрос получит 400 с кодом `invalid_request` и сообщением, что ключ передан в адресе. Так ключ не попадает в логи и историю браузера. Если ключ уже побывал в адресе, лучше создать новый.

На путях Gemini `/v1beta/…` для совместимости с Google принимается `?key=` — с самым низким приоритетом, после заголовков. `?api_key=` там тоже отклоняется с 400. Надёжнее всё равно передавать ключ в заголовке `x-goog-api-key`.

## [](https://ailoot.ai/docs/ru/keys/#env)Переменные окружения

Удобно завести одну переменную и подставлять её в настройки разных программ:

```bash
# ~/.zshrc или ~/.bashrc
export AILOOT_API_KEY="sk-..."

# для программ, которые читают стандартные имена
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
```

```powershell
setx AILOOT_API_KEY "sk-..."

# для программ, которые читают стандартные имена
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# перезапустите терминал, чтобы переменные подхватились
```

## [](https://ailoot.ai/docs/ru/keys/#check)Проверка ключа

Самый дешёвый способ проверить ключ — запросить список моделей: это бесплатно.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Остались вопросы? Пришлите Request ID и описание — поможем разобраться.[Написать в поддержку](mailto:support@ailoot.ai)

## Ailoot · Компания и портфель её проектов





Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.





Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.





Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.