Ключи и адрес API
MarkdownГде взять ключ, какой адрес указывать в разных SDK и как передавать ключ.
Полное руководство
Ключ API
Ключ создаётся в кабинете на ailoot.ai после регистрации. Он выглядит как sk-…. Можно завести несколько ключей: отдельно для рабочего компьютера, сервера и каждого приложения — так проще отозвать один, не трогая остальные.
У ключа можно задать общий лимит трат, срок действия, белый и чёрный списки IP-адресов и лимиты трат за окна 5 часов, 1 день и 7 дней. Если ограничение сработает, придёт понятная ошибка: api_key_quota_exhausted (исчерпан общий лимит), usage_limit_reached (исчерпано окно трат ключа — подождите, пока окно обновится, или поднимите лимит), api_key_expired или permission_denied (например, запрос не с разрешённого IP).
Адрес 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 | как указано |
Как передать ключ
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.
Переменные окружения
Удобно завести одну переменную и подставлять её в настройки разных программ:
# ~/.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"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-..."
# перезапустите терминал, чтобы переменные подхватилисьПроверка ключа
Самый дешёвый способ проверить ключ — запросить список моделей: это бесплатно.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"