Перейти к основному содержанию
Claude можно вызывать в двух форматах: в нативном формате Anthropic (Messages API, адрес /v1/messages) и в OpenAI-совместимом (Chat Completions, адрес /v1/chat/completions). В RuAPI один ключ работает в обоих форматах, и цена одна и та же; различаются они тем, как пишется запрос и какие возможности доступны. Ниже — в чём разница и какой формат выбрать. RuAPI работает из России без VPN, баланс пополняется в USDT.

Коротко

  • Если в инструменте можно выбрать провайдер Anthropic или приложение работает только с Claude, выбирайте нативный формат Anthropic. Запросы пишутся так же, как в официальной документации Anthropic, а кэш работает как при прямом подключении к Anthropic: Claude Code и похожие инструменты сами ставят метки кэша. Claude Code работает только в этом формате.
  • Если инструмент поддерживает только формат OpenAI или в одном и том же коде нужно переключаться между Claude, GPT, DeepSeek и Gemini, выбирайте OpenAI-совместимый формат. В RuAPI в нём тоже работают кэш, рассуждения и PDF; для кэша в запросе нужны метки cache_control.

Чем отличаются форматы

Что OpenAI-совместимый формат RuAPI умеет сверх слоя Anthropic

У Anthropic есть собственный OpenAI-совместимый слой. В официальной документации сказано, что он предназначен в первую очередь для тестирования и сравнения моделей, для большинства задач не считается долгосрочным решением для продакшена, а многие возможности в нём недоступны. В RuAPI запросы в OpenAI-совместимом формате мы сами преобразуем в нативные запросы Claude, поэтому всё перечисленное ниже работает: Данные по Anthropic — из официальной документации OpenAI SDK compatibility (проверено 19.10.2026).

Что выбрать

Агенты для программирования

Нужен ли /v1 в адресе для нативного формата Anthropic, зависит от инструмента: в Claude Code, Cline, Roo Code, OpenClaw и Anthropic SDK — без /v1, в Kilo Code, Continue и OpenCode — с /v1. Указывайте адрес точно как в таблице, иначе подключение не заработает. В OpenAI-совместимом формате адрес всегда с /v1.
Остальные инструменты (JetBrains AI Assistant, n8n, Cherry Studio и другие) подключаются в OpenAI-совместимом формате по своим инструкциям, адрес — https://www.ruapi.ai/v1. Claude при таком подключении тоже работает, но если инструмент не ставит метки кэша, кэша не будет, и длинные диалоги обойдутся дороже.

Своё приложение

  • Только Claude: Anthropic SDK (pip install anthropic), base_url="https://www.ruapi.ai". Здесь больше всего возможностей: кэш, рассуждения и PDF настраиваются так же, как в официальной документации Anthropic.
  • Модели разных компаний вперемешку: OpenAI SDK, base_url="https://www.ruapi.ai/v1"; чтобы сменить модель, достаточно поменять model. Для кэша Claude добавьте в запрос метки cache_control — как это сделать, описано на странице Кэширование промптов.

Один и тот же запрос в двух форматах

Оба примера делают одно и то же: задают Claude вопрос с системным промптом и просят вернуть текст рассуждений.
Простейший запрос через curl:

Как узнать, какой у вас формат

Откройте в Журнале запросов консоли запись с Claude и посмотрите строку «Путь запроса»: /v1/chat/completions — OpenAI-совместимый формат, /v1/messages — нативный формат Anthropic. Другие способы — в разделе «Какой формат у вас» на странице Кэширование промптов.

Частые вопросы

Да. RuAPI тарифицирует по модели, формат на цену не влияет. Один ключ работает в обоих форматах — отдельный ключ создавать не нужно.
Скорее всего, не срабатывает кэш, и повторяющийся контекст каждый раз оплачивается по полной цене. Выберите в инструменте провайдер Anthropic или добавьте в запрос метки cache_control. Пошаговая проверка — в частых вопросах на странице Кэширование промптов.
Посмотрите finish_reason (OpenAI-совместимый формат) или stop_reason (нативный формат Anthropic): length или max_tokens означает, что ответ упёрся в лимит длины. Если max_tokens в запросе не указан, RuAPI подставляет 8192 токена; для длинных ответов укажите max_tokens побольше. Токены рассуждений тоже входят в max_tokens.
Модели Claude 5 (например, Sonnet 5.5, Opus 5.5 и Haiku 5.5) рассуждают по умолчанию, но текст рассуждений не возвращают. В нативном формате Anthropic его нужно запросить явно: thinking: {"type": "adaptive", "display": "summarized"}. В OpenAI-совместимом формате достаточно указать reasoning_effort — остальное RuAPI сделает сам. На простой вопрос Claude может ответить сразу, без рассуждений, и тогда пустой текст рассуждений — это нормально.
Claude Opus 5.5, Claude Sonnet 5.5 и Claude Fable 5.1 не поддерживают принудительный вызов инструментов: tool_choice: "required" или имя конкретной функции в OpenAI-совместимом формате, как и {"type": "any"} или {"type": "tool"} в нативном формате Anthropic, одинаково дают ошибку 400. Используйте auto и опишите в промпте, когда нужно вызывать инструмент. Источник — официальная документация Anthropic Thinking (проверено 19.10.2026).
Такой кэш есть не везде: собственный OpenAI-совместимый слой Anthropic кэширование не поддерживает, а в документации некоторых шлюзов прямо сказано, что скидка за кэш действует только в нативном формате Anthropic. В RuAPI кэш Claude работает в обоих форматах.

Дальше