Миграция с OpenAI

Три строки диффа. Ваш существующий OpenAI SDK продолжает работать.

Патч

- client = OpenAI()
+ client = OpenAI(
+ api_key=os.environ["ONEPROVIDER_KEY"],
+ base_url="https://api.oneprovider.dev/v1",
+ )

Выбор модели по задаче

Мы не обещаем выдуманное соответствие «модель A равна модели B». Выберите актуальный GPT-тир по требованиям к качеству, цене и задержке:

Что работает без изменений

• chat.completions.create с messages, temperature, max_tokens, stream.
• Function-calling через tools; tool_choice: "auto".
• JSON-режим (response_format: {"type": "json_object"}).
• Стриминг через async-итераторы и в Python, и в Node.

Что меняется

• seed и logprobs молча игнорируются.
• Возвращаемые ID имеют префикс chatcmpl-op- вместо chatcmpl-.
• Legacy-форма function_call внутри маппится в Anthropic tool_use; поверхность ответа не меняется.

Использование OpenAI Codex CLI

Если вы используете Codex CLI от OpenAI, направьте его на наш Responses API и используйте тот же ключ. Полная настройка на странице клиента Codex — TL;DR: ~/.codex/auth.json для ключа, ~/.codex/config.toml с base_url = "https://api.oneprovider.dev/v1" и wire_api = "responses".

Проверка после миграции

response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "Reply with: migration works"}],
)
print(response.choices[0].message.content)

Переход с OpenRouter или другого шлюза

Что меняется в моём клиенте?

Три настройки: base URL, ключ и id модели. OpenAI SDK и OpenAI-совместимые инструменты используют https://api.oneprovider.dev/v1; Claude Code и Anthropic SDK используют https://api.oneprovider.dev. Один ключ OneProvider работает за обоими адресами.

Чем отличаются id моделей?

Id в OneProvider без префикса вендора, например claude-sonnet-5-5 или gpt-5.6-terra. Копируйте их со страницы моделей : неизвестный id даёт 400 с описанием проблемы.

Что даёт OneProvider?

Anthropic-нативный и OpenAI-совместимый эндпоинты под одним ключом, предоплаченный баланс без срока действия и без подписки, пополнение криптовалютой, картами, Apple Pay, Google Pay или СБП, лимит расхода и срок у каждого ключа и журнал каждого запроса. По политике текст запросов не хранится; серверы во Франкфурте.

Как сравнить стоимость?

Сравнивайте одну и ту же модель: ставки за миллион токенов, включая ставки кэша, указаны на странице тарифов . Затем запустите реальную задачу и посмотрите списание в журнале «Расход».

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

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