Документация API

Один ключ и два совместимых base URL для production-моделей, клиентов и media API.

Для ИИ-агента

Не получается? Отдайте это ИИ-агенту

Отправьте любому ИИ-агенту (Claude Code, Codex, Cursor…) ссылку ниже и попросите настроить клиент: там всё для агента, от настроек каждого клиента до проверки.

Три шага

1. Получите ключ в кабинете

   Откройте кабинет, пополните баланс (или активируйте код с маркетплейса) и нажмите «Выпустить ключ».

   app.oneprovider.dev Бот в Telegram Как это работает

2. Выберите свой клиент

   У каждого клиента своя короткая инструкция.

   • Claude Code
   • Claude Desktop
   • Codex (OpenAI)
   • Cursor
   • Hermes Agent
   • Cline
   • OpenClaw
   • VS Code
   • OpenCode
   • Open Cowork
   • Factory Droid
   • n8n
   • Python SDK
   • Node SDK

3. Укажите base URL и ключ

   Ключ — в заголовок x-api-key или Authorization: Bearer. Адрес зависит от типа клиента:

   Anthropic (Claude Code, Anthropic SDK), без /v1 https://api.oneprovider.dev OpenAI (Codex, Cursor, OpenAI SDK), с /v1 https://api.oneprovider.dev/v1 bash

   curl -s https://api.oneprovider.dev/v1/models \
   -H "Authorization: Bearer sk-your-key-here"

   Список моделей в ответе значит, что ключ работает.

Дальше

• Модели и цены
• Аутентификация
• Messages API
• Chat Completions
• Кабинет и ключи
• Ошибки и диагностика

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

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