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 |
Не используйте один общий endpoint для всех протоколов.
Авторизация и примеры
Передавайте API Key BetterToken вместе с запросом:
Claude Code / Anthropic
Codex / OpenAI Responses
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"}],
)
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 '{ ... }'
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",
)
curl https://www.bettertoken.ai/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "content-type: application/json" -d '{ ... }'
Правила выбора модели
- 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-моделей
Для внешних инструментов обычно достаточно Base URL, API Key и модели, которые указаны в официальной документации инструмента. Добавляйте дополнительные headers только если сам инструмент или ваш upstream gateway явно требуют этого.
Справочник переменных окружения
| Переменная | Значение | Где используется |
|---|
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 |