глава 01

Получить API-ключ

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

Где взять

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

| Провайдер | Модель | Где создать ключ | | --- | --- | --- | | OpenAI | ChatGPT (gpt-...) | platform.openai.com | | Anthropic | Claude (claude-...) | console.anthropic.com |

1
Зарегистрироваться
Завести аккаунт на platform.openai.com (OpenAI) или console.anthropic.com (Anthropic).
2
Открыть раздел API keys
В настройках аккаунта найти раздел с ключами - обычно называется API keys.
3
Создать ключ
Нажать создать новый ключ, дать ему понятное имя.
4
Скопировать сразу
Ключ показывают один раз. Скопируйте и сохраните - потом увидеть его целиком уже нельзя, только пересоздать.

Ключ выглядит как длинная строка вида sk-.... Это и есть то, что вы вставите в свой код (точнее - в .env, см. ниже).

Оплата: нужна зарубежная карта

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

Как её получить - отдельная тема, разобрана в материале про зарубежные платежи. Сколько именно списывают за запрос и что такое токены - в главе про токены.

Доступ из России

Сайты и API обоих провайдеров напрямую из РФ не открываются. Нужен прокси или VPN.

  • Для сервера и кода - прокси: запросы вашего приложения идут через зарубежный IP.
  • Для входа в личный кабинет с компьютера - VPN (Happ): чтобы открыть platform.openai.com или console.anthropic.com и создать ключ.

Ключ - в .env, не в код

Главное правило: ключ нельзя писать прямо в коде и нельзя коммитить в гит. Если ключ попадёт в публичный репозиторий, его за минуты найдут боты и потратят ваш баланс.

Ключ кладут в файл .env - это локальный файл с секретами, который добавляют в .gitignore и не загружают в репозиторий. В коде значение читают из окружения. Как это сделать на практике - в главе Общие принципы.

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...