> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Справочник API

> Endpoint, авторизация и настройка BetterToken по протоколам.

## Endpoint

BetterToken использует два endpoint в зависимости от протокола:

| Сценарий                                        | Base URL                        | Протокол                        |
| ----------------------------------------------- | ------------------------------- | ------------------------------- |
| Claude Code / `ANTHROPIC_BASE_URL`              | `https://www.bettertoken.ai`    | Anthropic                       |
| Codex / `OPENAI_BASE_URL` / внешние инструменты | `https://www.bettertoken.ai/v1` | OpenAI-style / OpenAI Responses |

<Warning>
  Не используйте один общий endpoint для всех протоколов.
</Warning>

## Авторизация и примеры

Передавайте API Key BetterToken вместе с запросом:

<Tabs>
  <Tab title="Claude Code / Anthropic">
    ```python theme={null}
    import anthropic

    client = anthropic.Anthropic(
        base_url="https://www.bettertoken.ai",
        api_key="YOUR_API_KEY",
    )

    message = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=1024,
        messages=[{"role": "user", "content": "Hello"}],
    )
    ```

    ```bash theme={null}
    curl https://www.bettertoken.ai/messages       -H "x-api-key: YOUR_API_KEY"       -H "anthropic-version: 2023-06-01"       -H "content-type: application/json"       -d '{ ... }'
    ```
  </Tab>

  <Tab title="Codex / OpenAI Responses">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        base_url="https://www.bettertoken.ai/v1",
        api_key="YOUR_API_KEY",
    )

    response = client.responses.create(
        model="ID модели Codex group, скопированный из https://www.bettertoken.ai/pricing",
        input="Hello",
    )
    ```

    ```bash theme={null}
    curl https://www.bettertoken.ai/v1/chat/completions       -H "Authorization: Bearer YOUR_API_KEY"       -H "content-type: application/json"       -d '{ ... }'
    ```
  </Tab>
</Tabs>

## Правила выбора модели

* **Claude Code + ключи `Claude_*`**: не задавайте переменные моделей вручную; настройте только `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN`
* **Claude Code + ключи `Codex_*`**: добавьте сопоставления через `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_OPUS_MODEL`
* **Codex**: используйте ID модели из **Codex group** в model plaza (`https://www.bettertoken.ai/pricing`)
* **Внешние инструменты**: также используйте модели **Codex group**, а не фиксированные имена Claude-моделей

<Note>
  Для внешних инструментов обычно достаточно `Base URL`, API Key и модели, которые указаны в официальной документации инструмента. Добавляйте дополнительные headers только если сам инструмент или ваш upstream gateway явно требуют этого.
</Note>

## Справочник переменных окружения

| Переменная                                 | Значение                        | Где используется                        |
| ------------------------------------------ | ------------------------------- | --------------------------------------- |
| `ANTHROPIC_BASE_URL`                       | `https://www.bettertoken.ai`    | Claude Code                             |
| `ANTHROPIC_AUTH_TOKEN`                     | Ваш API Key                     | Авторизация Claude Code                 |
| `OPENAI_BASE_URL`                          | `https://www.bettertoken.ai/v1` | Codex и другие OpenAI-style инструменты |
| `OPENAI_API_KEY`                           | Ваш API Key                     | Авторизация OpenAI-style инструментов   |
| `API_TIMEOUT_MS`                           | `3000000`                       | Рекомендуется для длинных задач         |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1`                             | Только Claude Code                      |