Аутентификация

OneProvider принимает и Bearer (стиль OpenAI), и x-api-key (стиль Anthropic). Передавайте один — никогда оба.

Формы заголовков

API принимает любой из этих заголовков. Используйте тот, что уже отправляет ваш SDK.

Authorization: Bearer sk-... # стиль OpenAI
x-api-key: sk-... # стиль Anthropic

Переменные окружения

В наших примерах ключ живёт в ONEPROVIDER_KEY. SDK-клиенты, однако, по умолчанию читают свои нативные имена — либо экспортируйте ключ под нужным именем, либо передавайте ONEPROVIDER_KEY явно в конструктор. В таблице ниже — что читает каждый инструмент:

Проверка аутентификации

Сделайте дешёвый запрос без побочных эффектов на /v1/models:

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Успешный ответ перечисляет текущие модели. 401 здесь означает, что ключ некорректный, отозванный или ещё не активирован.

Где хранить ключ

• Переменные окружения — дефолт для большинства сценариев.
• ~/.zshrc / ~/.bashrc с HISTCONTROL=ignorespace, чтобы команды с ведущим пробелом не попадали в shell-историю.
• Менеджеры секретов: 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• Файлы .env внутри проекта — всегда в .gitignore.

Типовые подводные камни

• Слэш на конце. https://api.oneprovider.dev/v1/ против https://api.oneprovider.dev/v1 — некоторые SDK конкатенируют путь наивно. Используйте форму без слэша на конце.
• Двойной Bearer. Authorization: Bearer Bearer sk-... случается, когда инструмент уже добавляет Bearer, а вы добавляете повторно. Уберите префикс в конфиге.
• Заголовок версии Anthropic. Всегда добавляйте anthropic-version: 2023-06-01 в сырых HTTP-вызовах. SDK добавляют сами.

Ротация ключей

Выпустите новый ключ в кабинете («Ключи» → «Выпустить ключ»), обновите его в своих клиентах и удалите старый. Это мгновенно и бесплатно, баланс общий для всех ключей кабинета. Подробнее — Кабинет и ключи .

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

Какой 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 или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .