Вызовы моделей

Как заполнять Base URL?

Как сопоставлять Base URL, путь /v1, API Key и Model ID в Claude Code, Codex CLI, Cursor, Cline и других инструментах. С настройкой, примерами и ошибками.

Короткий ответ

Base URL должен соответствовать protocol, который ожидает инструмент. Claude Code обычно использует корневой Anthropic-compatible адрес. Codex CLI, Cursor, Cline, OpenCode, OpenClaw и другие внешние инструменты обычно используют OpenAI-compatible адрес с /v1.

В BetterToken:

Сценарий	Base URL
Claude Code / Anthropic-compatible	`https://bettertoken.ai`
Codex CLI / OpenAI-compatible	`https://bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://bettertoken.ai/v1`

Для Claude Code используйте https://bettertoken.ai, для Codex CLI и OpenAI-compatible инструментов — https://bettertoken.ai/v1. Адрес зависит от протокола клиента.

Почему Base URL отличаются

Разные SDK по-разному добавляют пути к адресу.

Protocol или тип инструмента	Частое поведение
OpenAI-compatible SDK	Обычно вызывает chat completions, responses и другие ресурсы внутри `/v1`
Anthropic-compatible SDK	Обычно сам добавляет путь messages endpoint, поэтому не нужно повторно добавлять `/v1`
Встроенный provider в инструменте	Может добавлять путь автоматически или требовать полный Base URL

Быстрая таблица

Инструмент	Рекомендуемая настройка
Claude Code	`https://bettertoken.ai`, API Key BetterToken
Claude Desktop Gateway	По инструкции Gateway, включая auth scheme
Codex CLI	`https://bettertoken.ai/v1`, API Key BetterToken
Cursor	`https://bettertoken.ai/v1`, API Key BetterToken
Cline	`https://bettertoken.ai/v1`, provider OpenAI Compatible
OpenCode / OpenClaw	`https://bettertoken.ai/v1`, API Key BetterToken

Частые ошибки

Ошибка или симптом	Возможная причина
`404 Not Found`	Путь в Base URL не совпадает с тем, что ожидает SDK
`model not found`	Сверьте точный Model ID с model plaza и укажите его в настройках модели клиента.
`invalid_api_key`	API Key и Base URL взяты из разных сервисов
Авторизация проходит, но модель недоступна	Сверьте точный Model ID с model plaza и укажите его в настройках модели клиента.
Запросы постоянно падают	Anthropic-compatible адрес указан в OpenAI-compatible инструменте или наоборот

Примеры кода

OpenAI-compatible инструменты обычно используют адрес с /v1:

from openai import OpenAI

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

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)

Claude / Anthropic-compatible настройки обычно используют корневой адрес:

import anthropic

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

message = client.messages.create(
    model="your-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)

О BetterToken

BetterToken поддерживает Anthropic-compatible и OpenAI-compatible доступ. Вы можете управлять API Keys, балансом и usage records в одном dashboard, но каждый клиент должен использовать адрес protocol, который он поддерживает.

Короткое правило: Claude Code использует https://bettertoken.ai; Codex CLI, Cursor, Cline, OpenCode и OpenClaw используют https://bettertoken.ai/v1.