Начало работы

Обзор API

Знакомство с API OneProvider: один base URL понимает форматы Anthropic Messages и OpenAI. Аутентификация, версии и карта всех страниц раздела.

Один эндпоинт. Два проводных формата. Актуальные модели Claude и GPT. Вся поверхность API на одной странице.

Все модели, характеристики и цены Индекс документации для AI-агентов: https://oneprovider.dev/docs/llms.txt

Эндпоинт

Все запросы идут на https://api.oneprovider.dev/v1. Нет регионального роутинга, нет per-tenant поддоменов, нет отдельного биллинг-хоста. API работает во Франкфурте (EU) и доступен по всему миру.

Проводные форматы

OneProvider говорит на двух протоколах по одному и тому же URL. Берите тот, на котором уже работает ваш SDK — оба first-class, ни один не translation-слой.

Anthropic-нативный. POST /v1/messages — байт-в-байт идентичен api.anthropic.com. Если ваш код сегодня ходит в Anthropic, замена base_url — вся миграция.
OpenAI-совместимый. POST /v1/chat/completions — drop-in для OpenAI SDK. Tool calling, стриминг, vision — всё работает; только поля без эквивалента у Claude (например response_format=json_schema strict mode) тихо игнорируются.

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

Либо Authorization: Bearer sk-..., либо x-api-key: sk-.... Никогда оба сразу — см. Аутентификацию .

Версионирование

Путь — /v1/* на каждом эндпоинте. Anthropic-запросы дополнительно принимают anthropic-version: 2023-06-01 — SDK добавляют его сами.

Мы никогда не ломаем /v1. Новые возможности приезжают как additive поля (например, блоки cache_control). Удаления или схема-ломающие изменения поедут на /v2 минимум с 90 днями overlap.

Страницы этого раздела

API Chat completions OpenAI-compatible endpoint. API POST /v1/messages Anthropic-native schema. API Tool use tool_choice normalization. API Vision (image input) image content blocks. API Usage & billing Per-request usage; balance endpoint.

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

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

Последнее обновление: 2026-10-05 Нашли ошибку? @Oneproviderhelpbot