API-ключи

Ключ — это и логин, и пароль к вашему балансу. Один ключ работает со всеми моделями каталога; запросы тарифицируются с того же баланса.

Как создать ключ

1. Войдите в кабинет и пополните баланс — без средств запросы возвращают ошибку 402.
2. Откройте раздел API-ключи и нажмите Создать ключ.
3. Скопируйте ключ сразу — он показывается один раз. Формат — строка вида cai-xxxxxxxxxxxxxxxxxxxxxxxx.

Как передавать ключ в запросах

Для OpenAI-совместимого API — заголовок Authorization:

curl

curl https://api.cheapai.io/v1/chat/completions \
  -H "Authorization: Bearer cai-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Привет!"}]}'

В SDK — тот же ключ в поле api_key вместе с base_url:

python

from openai import OpenAI
client = OpenAI(base_url="https://api.cheapai.io/v1", api_key="cai-...")

Для Claude Code и других Anthropic-совместимых клиентов — через переменные окружения:

claude code · терминал

export ANTHROPIC_BASE_URL="https://api.cheapai.io"
export ANTHROPIC_AUTH_TOKEN="cai-..."

Подробные инструкции по клиентам — Claude Code, Codex CLI, Cursor и другие.

Где хранить ключ

• В переменной окружения (export CHEAPAI_API_KEY=...) или в .env, который добавлен в .gitignore.
• В секретах CI / хостинга — не в коде и не в конфиге, который попадает в репозиторий.
• Не передавайте ключ в браузерный код — любой пользователь страницы увидит его в DevTools. Браузерные приложения должны ходить в API через свой бэкенд.

Отзыв и ротация

В разделе API-ключи ключ можно отозвать — после этого запросы с ним сразу начинают возвращать . Баланс при этом не меняется: он общий для аккаунта, а не привязан к конкретному ключу.