Если вы по-прежнему поддерживаете установки Roo Code, путь Roo Code OpenAI compatible API в основном сводится к настройке: тип провайдера, Base URL, API key и Model ID. Риск для продакшена — в той части, которую легко упустить. Документация провайдера Roo Code для этого пути требует нативный OpenAI-style tool calling, поэтому одного обычного chat response недостаточно, чтобы считать workflow для coding agent подтверждённым.
Это руководство показывает, как направить существующие конфигурации Roo Code через Flatkey для developers, AI product teams, automation builders, platform engineers, finance operators и procurement reviewers. Оно охватывает текущую оговорку Roo Code, проверку base URL в Flatkey, точные model aliases, предварительную проверку native tool-call, настройки Roo Code, просмотр использования и rollback.
Источник: это было проверено 29 июня 2026 года по официальной главной странице документации Roo Code, официальной документации провайдера Roo Code OpenAI Compatible, публичным страницам Flatkey в реальном времени и одному аутентифицированному smoke test через gateway Flatkey. На главной странице документации Roo Code указано, что расширение Roo Code было отключено 15 мая 2026 года, поэтому рассматривайте это как руководство по настройке для существующих установок, архивных конфигураций или проверки миграции, а не как рекомендацию стандартизировать новый rollout без проверки доступности расширения.
Краткий ответ: настройка Roo Code OpenAI compatible API
Для настройки Roo Code OpenAI compatible API с Flatkey выберите OpenAI Compatible в качестве API provider, вставьте текущий Flatkey base URL, используйте Flatkey API key и укажите точный Flatkey model alias, который поддерживает OpenAI-compatible chat и native tool calling. Затем проверьте маршрут с помощью небольшого запроса curl, прежде чем доверять ему в рабочем code workspace.
| Поле Roo Code | Значение Flatkey | Проверка |
|---|---|---|
| API Provider | OpenAI Compatible | Используйте этого провайдера для Flatkey, а не официальный провайдер OpenAI. |
| Base URL | Текущий base URL провайдера Flatkey для вашей учётной записи, например https://router.flatkey.ai/v1, если это подтверждённое значение |
Вставляйте только base URL. Не вставляйте полный endpoint /chat/completions в Roo Code. |
| API Key | Ключ Flatkey, принадлежащий нужному пользователю, команде или окружению | Не смешивайте ключи upstream provider с base URL Flatkey. |
| Model ID | Точный Flatkey model alias, включённый для этого ключа | Перед использованием в coding tasks подтвердите, что alias поддерживает OpenAI chat endpoint и native tool calls. |
| Validation | Небольшой smoke test для chat и tool-call, затем один безопасный prompt Roo Code | После теста проверьте Flatkey usage, чтобы finance и platform owners могли сверить маршрут. |
Самый короткий безопасный путь: подтвердить транспорт Flatkey, подтвердить model alias, подтвердить native tool calling, а затем сохранить настройки Roo Code. Остальная часть этого руководства Roo Code OpenAI compatible API превращает это в повторяемый checklist.
Что подтверждают текущие документы Roo Code
На главной странице документации Roo Code сейчас отображается предупреждение о прекращении поддержки расширения. Это важно учитывать при планировании. Если ваша команда уже использует установленный Roo Code, приведённые ниже сведения о конфигурации по-прежнему полезны для обслуживания и анализа миграции. Если ваша команда выбирает нового стандартного ассистента для программирования, сначала проверьте статус расширения, магазина и форка, прежде чем назначать Roo Code более широкой группе.
На странице поставщика Roo Code OpenAI Compatible указаны три основных значения для этого класса поставщика: Base URL, API Key и Model ID. Там также сказано выбрать OpenAI Compatible в качестве поставщика API. Base URL — это конечная точка поставщика, и это явно не официальный URL OpenAI API, если вы используете несовместимого с OpenAI поставщика.
Важное ограничение Roo связано с вызовом инструментов. На той же странице поставщика сказано, что Roo Code использует исключительно нативный вызов инструментов и не имеет XML-резервного варианта. Там также указано, что выбранная модель должна поддерживать совместимый с OpenAI вызов инструментов. Для маршрута Roo Code OpenAI compatible API через Flatkey это означает, что псевдоним модели нельзя проверить только обычной генерацией текста.
Значения Flatkey, которые нужно подтвердить перед открытием Roo Code
1. Подтвердите базовый URL для вашей учётной записи
На главной странице Flatkey, проверенной 29 июня 2026 года, указан заголовок One API gateway for production AI teams, а в метаописании говорится, что Flatkey объединяет доступ к моделям, маршрутизацию, биллинг, аналитику использования и операционные средства контроля. В публичных примерах на главной странице используются chat completions в стиле OpenAI. Проверка во время выполнения для этой статьи использовала https://router.flatkey.ai/v1 и вернула корректный список моделей.
Поскольку публичные примеры и маршруты, зависящие от учётной записи, со временем могут отличаться, перед запуском в production скопируйте текущий базовый URL Flatkey из консоли, документации или рабочей среды. В Roo Code в качестве Base URL должен использоваться базовый URL поставщика, а не /v1/chat/completions.
2. Подтвердите псевдоним модели и поддержку инструментов
На странице тарифов Flatkey, проверенной 29 июня 2026 года, указано, что компания публикует цены, отрисованные на сервере, для 635 моделей ИИ от 23 поставщиков. Карта конечных точек включает /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations и /v1/video/generations. Это свидетельство каталога и конечных точек, а не обещание, что каждый ключ Flatkey может вызывать каждую модель.
Для настройки Roo Code OpenAI compatible API выберите один видимый в учётной записи псевдоним модели, который поддерживает совместимые с OpenAI chat и вызовы инструментов. Проверка с аутентификацией для этой статьи вернула 56 моделей, видимых в учётной записи, а небольшой запрос на вызов инструмента с gpt-5.4-mini вернул HTTP 200 с finish_reason: tool_calls и метаданными использования. Рассматривайте это как подтверждение маршрута на момент проверки для тестовой учётной записи, а не как постоянную рекомендацию для каждого рабочего пространства Flatkey.
3. Подтвердите владение ключом и проверку использования
Roo Code может работать с рабочим пространством кода, поэтому важна принадлежность ключа. Используйте ключ Flatkey, ограниченный разработчиком, командой или средой, которая несёт риск. Зафиксируйте, кто может ротировать ключ, какой псевдоним модели разрешён, какое семейство конечных точек ожидается и где будет проверяться журнал использования после первого запроса.
Пошагово: настройка Roo Code с Flatkey
- Проверьте, является ли это уже существующей установкой Roo Code. Поскольку в официальной документации сейчас упоминается отключение расширения, не начинайте с предположения, что доступна свежая установка из маркетплейса.
- Откройте настройки провайдера Roo Code. В конфигурации существующего расширения перейдите в раздел провайдера модели или настройки API.
- Выберите OpenAI Compatible. Используйте тип провайдера, который Roo Code документирует для конечных точек, совместимых с OpenAI.
- Установите Base URL. Введите подтвержденный базовый URL Flatkey, например
https://router.flatkey.ai/v1, если это актуальное рабочее значение для вашей учетной записи. - Вставьте API-ключ Flatkey. Не храните его в файлах репозитория, комментариях к issue, скриншотах и промптах.
- Установите Model ID. Введите точный псевдоним модели Flatkey. Не используйте общее имя семейства вендора, если только Flatkey не предоставляет этот точный псевдоним вашему ключу.
- Запустите приведенный ниже предварительный curl-проверочный запрос. Обычный чат полезен, но Roo Code требует нативного вызова инструментов, поэтому включите в тест схему инструмента.
- Запустите один безопасный запрос Roo Code. Используйте одноразовое рабочее пространство или неразрушающую задачу, прежде чем направлять Roo Code к рабочим репозиториям.
- Проверьте использование Flatkey. Подтвердите видимость времени, владельца ключа, псевдонима модели, использования токенов, статуса и стоимости.
- Документируйте откат. Сохраните предыдущие настройки провайдера, псевдоним модели и владельца, прежде чем просить других разработчиков переключиться.
Шаблон предварительной проверки нативного вызова инструментов
Самый безопасный способ отладить настройку Roo Code OpenAI compatible API — сначала протестировать маршрут Flatkey вне Roo Code. Этот шаблон проверяет конечную точку чата и просит модель вернуть вызов инструмента в стиле OpenAI.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="replace-with-tool-capable-flatkey-model"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_ROO_MODEL"'",
"messages": [
{
"role": "user",
"content": "Call route_check with status ok and do not include prose."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Return the routing smoke-test status.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Исправный ответ должен включать сообщение assistant с tool_calls. Если этот запрос не проходит, исправьте ключ Flatkey, базовый URL, псевдоним модели или возможности модели, прежде чем менять настройки Roo Code. Если он проходит, но Roo Code — нет, сосредоточьтесь на сохраненных полях Roo Code, локальном сетевом доступе, состоянии расширения или точном Model ID, введенном в настройках провайдера.
Сначала отлаживайте следующие режимы отказа
| Симптом | Вероятная причина | Исправление |
|---|---|---|
| Недействительный API-ключ | Ключ был скопирован неверно, отозван и перевыпущен, привязан к другой среде или относится к upstream-провайдеру, а не к Flatkey. | Возьмите новый ключ Flatkey, протестируйте его с помощью curl, затем вставьте тот же ключ в Roo Code. |
| Ошибка подключения | Неверный Base URL, в поле Base URL вставлен полный путь endpoint, заблокирован сетевой путь или проблема с локальным прокси. | Проверьте базовый URL провайдера с той же машины и повторно протестируйте /chat/completions. |
| Модель не найдена | Model ID в Roo Code не совпадает с alias Flatkey, который включен для ключа. | Скопируйте точный alias из прайсинга Flatkey, каталога или списка моделей, доступного в аккаунте. |
| Ошибка вызова инструментов | Выбранная модель может отвечать в чате, но не поддерживает нативные вызовы инструментов, совместимые с OpenAI. | Переключитесь на alias модели с поддержкой инструментов и повторите предварительную проверку перед использованием Roo Code. |
| Расширение недоступно | Текущее состояние распространения Roo Code не поддерживает планируемый путь установки или обновления. | Рассматривайте настройку как устаревшее сопровождение и выберите активный workflow для code agent для новых развертываний. |
| Невозможно сверить использование | Команда не зафиксировала владельца ключа, alias модели, пользователя Roo Code, среду или временную метку. | Добавьте строку в runbook, прежде чем расширять маршрут на большее число разработчиков. |
Существующая установка или новый стандарт?
Маршрут Roo Code OpenAI compatible API может быть полезен, но уведомление о прекращении работы расширения меняет решение. Используйте эту таблицу, прежде чем просить команду полагаться на него.
| Ситуация | Рекомендуемое действие | Почему это важно |
|---|---|---|
| Существующая установка Roo Code все еще используется разработчиком | Задокументируйте маршрут Flatkey, протестируйте вызовы инструментов и сохраните откат. | Сопровождение может продолжаться, пока команда планирует миграцию или замену. |
| Новый командный rollout code agent | Сначала проверьте текущую доступность расширения, затем сравните активные альтернативы. | Отключенное расширение может создать риски поддержки, безопасности и онбординга. |
| Стандартизация кластера интеграций с инструментами | Используйте один и тот же ключ Flatkey, base URL, model alias и шаблон журнала использования во всех инструментах. | Единообразие упрощает биллинг, отладку и проверку закупок. |
Production runbook для Roo Code и Flatkey
Прежде чем больше разработчиков начнут использовать маршрут Roo Code OpenAI compatible API, зафиксируйте операционные факты, которые делают возможными поддержку и проверку затрат.
| Поле runbook | Что записать |
|---|---|
| Область Roo Code | Существующая локальная установка, образ команды, архивированный профиль или тест только для миграции. |
| Ключ Flatkey | Владелец, среда, дата ротации и владелец отзыва. |
| Базовый URL | Точный базовый URL провайдера, сохранённый в Roo Code, и дата его проверки. |
| Псевдоним модели | Model ID Roo Code, псевдоним модели Flatkey, семейство endpoint и нативный результат вызова инструмента. |
| Smoke test | HTTP-статус, причина завершения, общее использование и появилось ли tool_calls. |
| Проверка использования | Где владельцы платформы и финансов проверяют объём запросов, стоимость и неожиданные изменения модели. |
| Откат | Предыдущая конфигурация провайдера, предыдущий псевдоним модели и кто может восстановить его. |
Путь внутренней миграции
Если ваша команда стандартизирует конфигурации инструментов OpenAI-compatible на Flatkey, держите эту настройку согласованной с остальной частью кластера интеграций. Используйте руководство по миграции OpenAI-compatible API как базовый URL и центр отката. Для другого шаблона настольного клиента сравните руководство по настройке API Cherry Studio. Для маршрутизации coding-agent на машинах разработчиков ознакомьтесь с руководством cc-switch Claude Code.
После того как первый безопасный запрос Roo Code сработает, изучите текущую страницу цен на модели Flatkey, затем получите ключ для каждого отдельного пользователя, команды или границы среды.
Часто задаваемые вопросы
Roo Code по-прежнему поддерживает провайдеров, совместимых с OpenAI?
В документации провайдера Roo Code OpenAI Compatible по-прежнему описаны поля провайдера: API Provider, Base URL, API Key и Model ID. На главной странице документации также указано, что расширение Roo Code было отключено 15 мая 2026 года, поэтому перед новым развёртыванием проверьте путь установки.
Какой Base URL следует использовать для провайдера API Roo Code, совместимого с OpenAI?
Используйте текущий базовый URL провайдера Flatkey для вашей учётной записи. В этой статье аутентифицированные проверки Flatkey использовали https://router.flatkey.ai/v1, тогда как публичные примеры могут меняться. В Roo Code вставляйте только базовый URL, а не полный endpoint chat-completions.
Почему требуется нативный вызов инструментов?
В документации провайдера Roo Code сказано, что нативный вызов инструментов — единственный поддерживаемый протокол инструментов для провайдеров, совместимых с OpenAI. Модели, которая может отвечать обычным чатом, но не может формировать вызовы инструментов в стиле OpenAI, недостаточно для надёжной настройки Roo Code.
Должен ли Model ID точно совпадать с псевдонимом модели Flatkey?
Да. Используйте точный псевдоним Flatkey, к которому может обращаться ваш ключ, и проверьте его с помощью smoke test вызова инструмента. Названия семейств моделей, маркетинговые названия провайдеров и псевдонимы шлюза могут различаться.
Можно ли использовать это руководство для новых развёртываний Roo Code?
Используйте его только после проверки текущей доступности Roo Code. Проверки маршрутизации Flatkey по-прежнему полезны, но уведомление об отключении Roo Code означает, что для новых развёртываний на уровне всей команды требуется явное решение о поддержке продукта.
Заключение
Безопасная настройка Roo Code OpenAI compatible API через Flatkey должна подтверждаться не только успешным ответом чата. Проверьте текущий base URL, используйте ключ, принадлежащий Flatkey, выберите точный alias модели, протестируйте нативные вызовы инструментов и убедитесь в видимости использования, прежде чем давать Roo Code доступ к реальной работе с кодом. Когда маршрут будет готов для другого пользователя или окружения, Получите ключ и держите строку отката рядом с инструкциями по настройке.
