Миграция с Anthropic

Если ваш код уже сегодня ходит в api.anthropic.com — вся миграция это одна переменная окружения. Существующие запросы и ответы байт-в-байт идентичны.

Что меняется (и что нет)

Ничего в схеме запроса, форме ответа, событиях стрима или SDK, который вы уже используете, менять не нужно. Единственная разница — куда уходят байты:

Миграция через env

Если ваш код читает учётки из переменных окружения (так и должно быть) — это вся правка:

# До
export ANTHROPIC_API_KEY=sk-ant-...
# После
export ANTHROPIC_API_KEY=sk-... # ключ OneProvider
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev

Официальные SDK Anthropic для Python и Node читают ANTHROPIC_BASE_URL — никаких других правок в коде не нужно.

Python — явная форма

# До
from anthropic import Anthropic
client = Anthropic()
# После
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["ANTHROPIC_API_KEY"],
base_url="https://api.oneprovider.dev",
)

Node — явная форма

// До
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
// После
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.ANTHROPIC_API_KEY,
baseURL: "https://api.oneprovider.dev",
});

Замена id моделей

OneProvider отдаёт актуальные Claude-id (список на странице Models) на Anthropic-нативной поверхности (/v1/messages). Если ваш код ссылается на старый Anthropic-алиас (claude-3-5-sonnet, claude-3-opus-20240229 и т.д.), вернётся 400 invalid_request_error — замените на текущий канонический id:

Проверка замены

# Должны напечататься текущие Claude-id
curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | jq '.data[].id'
# Должно вернуть HTTP 200 и короткий текстовый ответ
curl -s https://api.oneprovider.dev/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-5-5","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .