Si todavía mantienes instalaciones de Roo Code, la ruta de la API compatible con OpenAI de Roo Code es principalmente una superficie de configuración: tipo de proveedor, URL base, clave de API e ID del modelo. El riesgo de producción es la parte que es fácil pasar por alto. Los documentos del proveedor de Roo Code requieren llamadas a herramientas nativas al estilo de OpenAI para esta ruta, por lo que una simple respuesta de chat no es prueba suficiente para un flujo de trabajo de agente de codificación.
Esta guía muestra cómo enrutar las configuraciones existentes de Roo Code a través de Flatkey para desarrolladores, equipos de productos de IA, creadores de automatización, ingenieros de plataforma, operadores financieros y revisores de adquisiciones. Cubre la advertencia actual de Roo Code, la validación de la URL base de Flatkey, los alias de modelo exactos, la comprobación previa de llamadas a herramientas nativas, la configuración de Roo Code, la revisión del uso y la reversión.
Nota sobre la fuente: esto se verificó el 29 de junio de 2026 con la página principal de la documentación oficial de Roo Code, la documentación oficial del proveedor compatible con OpenAI de Roo Code, las páginas públicas activas de Flatkey y una prueba de humo de una puerta de enlace autenticada de Flatkey. La página principal de la documentación de Roo Code indica que la extensión de Roo Code se cerró el 15 de mayo de 2026, así que considera esto como una guía de configuración para instalaciones existentes, configuraciones archivadas o revisión de migración, en lugar de una recomendación para estandarizar un nuevo despliegue sin verificar la disponibilidad de la extensión.
Respuesta rápida: Configuración de la API compatible con OpenAI de Roo Code
Para una configuración de la API compatible con OpenAI de Roo Code con Flatkey, elige OpenAI Compatible como proveedor de API, pega una URL base actual de Flatkey, usa una clave de API de Flatkey e introduce un alias de modelo exacto de Flatkey que admita chat compatible con OpenAI y llamadas a herramientas nativas. Luego, prueba la ruta con una pequeña solicitud curl antes de confiar en ella dentro de un espacio de trabajo de código.
| Campo de Roo Code | Valor de Flatkey | Verificación de revisión |
|---|---|---|
| Proveedor de API | OpenAI Compatible | Usa este proveedor para Flatkey, no el proveedor oficial de OpenAI. |
| URL base | La URL base actual del proveedor de Flatkey para tu cuenta, como https://router.flatkey.ai/v1 cuando ese sea el valor verificado |
Pega solo la URL base. No pegues el endpoint completo /chat/completions en Roo Code. |
| Clave de API | Una clave de Flatkey propiedad del usuario, equipo o entorno correcto | No mezcles claves de proveedores ascendentes con la URL base de Flatkey. |
| ID del modelo | El alias de modelo exacto de Flatkey habilitado para esa clave | Confirma que el alias admite el endpoint de chat de OpenAI y las llamadas a herramientas nativas antes de usarlo para tareas de codificación. |
| Validación | Pequeña prueba de humo de chat más llamada a herramienta, luego una indicación segura de Roo Code | Verifica el uso de Flatkey después de la prueba para que los propietarios de finanzas y de la plataforma puedan conciliar la ruta. |
La ruta segura más corta es: probar el transporte de Flatkey, probar el alias del modelo, probar las llamadas a herramientas nativas y luego guardar la configuración de Roo Code. El resto de esta guía de la API compatible con OpenAI de Roo Code convierte eso en una lista de verificación repetible.
Lo que confirman los documentos actuales de Roo Code
La página principal de la documentación de Roo Code actualmente muestra una advertencia de cierre de la extensión. Eso es importante para la planificación. Si tu equipo está utilizando una instalación existente de Roo Code, los detalles de configuración a continuación siguen siendo útiles para el mantenimiento y la revisión de la migración. Si tu equipo está eligiendo un nuevo asistente de codificación estándar, primero verifica el estado de la extensión, el marketplace y la bifurcación antes de asignar Roo Code a un grupo más amplio.
La página del proveedor compatible con OpenAI de Roo Code documenta tres valores principales para esta clase de proveedor: URL base, Clave de API e ID del modelo. También indica que se debe seleccionar OpenAI Compatible como proveedor de API. La URL base es el endpoint del proveedor y explícitamente no es la URL oficial de la API de OpenAI cuando se utiliza un proveedor no compatible con OpenAI.
La restricción importante específica de Roo es la llamada a herramientas. La misma página del proveedor dice que Roo Code utiliza exclusivamente llamadas a herramientas nativas y no tiene una alternativa basada en XML. También dice que el modelo seleccionado debe admitir llamadas a herramientas compatibles con OpenAI. Para una ruta de la API compatible con OpenAI de Roo Code a través de Flatkey, eso significa que el alias del modelo no se puede validar solo con la generación de texto sin formato.
Valores de Flatkey a confirmar antes de abrir Roo Code
1. Confirma la URL base para tu cuenta
La página de inicio de Flatkey, verificada el 29 de junio de 2026, tiene el título One API gateway for production AI teams y una metadescripción que dice que Flatkey unifica el acceso a modelos, el enrutamiento, la facturación, el análisis de uso y los controles operativos. Los ejemplos de la página de inicio pública incluyen finalizaciones de chat al estilo de OpenAI. Una verificación en tiempo de ejecución autenticada para este artículo utilizó https://router.flatkey.ai/v1 y devolvió una lista de modelos válida.
Debido a que los ejemplos públicos y las rutas específicas de la cuenta pueden diferir con el tiempo, copia la URL base actual de Flatkey desde tu consola, documentos o entorno de trabajo antes de la producción. En Roo Code, la URL base debe ser la base del proveedor, no /v1/chat/completions.
2. Confirma el alias del modelo y el soporte para herramientas
La página de precios de Flatkey, consultada el 29 de junio de 2026, indica que publica precios renderizados en el servidor para 635 modelos de IA de 23 proveedores. Su mapa de endpoints incluye /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations y /v1/video/generations. Esto es una evidencia de catálogo y endpoints, no una promesa de que cada clave de Flatkey pueda llamar a todos los modelos.
Para una configuración de API compatible con OpenAI de Roo Code, elija un alias de modelo visible en la cuenta que admita chat y llamadas a herramientas compatibles con OpenAI. La verificación autenticada para este artículo devolvió 56 modelos visibles en la cuenta, y una pequeña solicitud de llamada a herramienta con gpt-5.4-mini devolvió un HTTP 200 con finish_reason: tool_calls y metadatos de uso. Considere esto como una prueba de ruta fechada para la cuenta probada, no como una recomendación permanente para cada espacio de trabajo de Flatkey.
3. Confirmar la propiedad de la clave y revisar el uso
Roo Code puede actuar en un espacio de trabajo de código, por lo que la propiedad de la clave es importante. Use una clave de Flatkey con el alcance limitado al desarrollador, equipo o entorno que asume el riesgo. Registre quién puede rotar la clave, qué alias de modelo está permitido, qué familia de endpoints se espera y dónde se revisará el registro de uso después de la primera solicitud.
Paso a paso: configurar Roo Code con Flatkey
- Verifique si se trata de una instalación existente de Roo Code. Dado que la documentación oficial menciona actualmente el cierre de la extensión, no comience asumiendo que hay una instalación nueva del marketplace disponible.
- Abra la configuración del proveedor de Roo Code. En la configuración de la extensión existente, vaya al área de configuración del proveedor de modelos o de la API.
- Seleccione OpenAI Compatible. Utilice el tipo de proveedor documentado por Roo Code para endpoints no compatibles con OpenAI.
- Establezca la URL base. Ingrese la URL base verificada de Flatkey, por ejemplo
https://router.flatkey.ai/v1cuando ese sea el valor de trabajo actual para su cuenta. - Pegue la clave de API de Flatkey. Manténgala fuera de los archivos del repositorio, comentarios de incidencias, capturas de pantalla y prompts.
- Establezca el ID del modelo. Ingrese el alias exacto del modelo de Flatkey. No utilice un nombre de familia de proveedor genérico a menos que Flatkey exponga ese alias exacto a su clave.
- Ejecute la comprobación previa (preflight) con curl a continuación. El chat simple es útil, pero Roo Code requiere llamadas a herramientas nativas, así que incluya un esquema de herramienta en la prueba.
- Ejecute un prompt seguro de Roo Code. Use un espacio de trabajo desechable o una tarea no destructiva antes de apuntar Roo Code a los repositorios de producción.
- Verifique el uso de Flatkey. Confirme la marca de tiempo, el propietario de la clave, el alias del modelo, el uso de tokens, el estado y la visibilidad de los costos.
- Documente la reversión (rollback). Guarde la configuración del proveedor anterior, el alias del modelo y el propietario antes de pedir a más desarrolladores que cambien.
Plantilla de comprobación previa (preflight) para llamadas a herramientas nativas
La forma más segura de depurar una configuración de API compatible con OpenAI de Roo Code es probar primero la ruta de Flatkey fuera de Roo Code. Esta plantilla verifica el endpoint de chat y le pide al modelo que devuelva una llamada a herramienta al estilo de OpenAI.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="reemplace-con-modelo-flatkey-capaz-de-herramientas"
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": "Llama a route_check con el estado ok y no incluyas prosa."
}
],
"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
}'Una respuesta correcta debería incluir un mensaje del asistente con tool_calls. Si esta solicitud falla, corrija la clave de Flatkey, la URL base, el alias del modelo o la capacidad del modelo antes de cambiar la configuración de Roo Code. Si tiene éxito pero Roo Code falla, céntrese en los campos guardados de Roo Code, el acceso a la red local, el estado de la extensión o el ID de modelo exacto ingresado en la configuración del proveedor.
Modos de fallo que depurar primero
| Síntoma | Causa probable | Solución |
|---|---|---|
| Clave de API no válida | La clave se copió incorrectamente, se rotó, se asignó a otro entorno o pertenece a un proveedor ascendente en lugar de a Flatkey. | Usa una clave de Flatkey nueva, pruébala con curl y luego pega la misma clave en Roo Code. |
| Error de conexión | URL base incorrecta, ruta completa del punto de conexión pegada en el campo de la URL base, ruta de red bloqueada o problema de proxy local. | Verifica la URL base del proveedor desde la misma máquina y vuelve a probar /chat/completions. |
| Modelo no encontrado | El ID del modelo de Roo Code no coincide con un alias de Flatkey habilitado para la clave. | Copia el alias exacto de la lista de precios, el catálogo o la lista de modelos visibles de la cuenta de Flatkey. |
| Error en la llamada a herramientas | El modelo seleccionado puede responder al chat, pero no admite llamadas a herramientas nativas compatibles con OpenAI. | Cambia a un alias de modelo con capacidad para herramientas y vuelve a ejecutar la comprobación previa antes de usar Roo Code. |
| Extensión no disponible | El estado de distribución actual de Roo Code no es compatible con la ruta de instalación o actualización planificada. | Trata la configuración como mantenimiento heredado y elige un flujo de trabajo de agente de codificación activo para las nuevas implementaciones. |
| No se puede conciliar el uso | El equipo no registró el propietario de la clave, el alias del modelo, el usuario de Roo Code, el entorno o la marca de tiempo. | Añade una fila al manual de procedimientos antes de ampliar la ruta a más desarrolladores. |
¿Instalación existente o nuevo estándar?
La ruta de la API compatible con OpenAI de Roo Code puede ser útil, pero el aviso de cierre de la extensión cambia la decisión. Usa esta tabla antes de pedirle a un equipo que confíe en ella.
| Situación | Acción recomendada | Por qué es importante |
|---|---|---|
| Instalación existente de Roo Code que todavía utiliza un desarrollador | Documenta la ruta de Flatkey, prueba las llamadas a herramientas y mantén la opción de reversión. | El mantenimiento puede continuar mientras el equipo planifica la migración o el reemplazo. |
| Nueva implementación de un agente de codificación para todo el equipo | Verifica primero la disponibilidad actual de la extensión y luego compara las alternativas activas. | Una extensión cerrada puede crear riesgos de soporte, seguridad e incorporación. |
| Estandarización del clúster de integración de herramientas | Usa la misma clave de Flatkey, URL base, alias de modelo y patrón de registro de uso en todas las herramientas. | La coherencia facilita la facturación, la depuración y la revisión de las adquisiciones. |
Manual de procedimientos de producción para Roo Code y Flatkey
Antes de que más desarrolladores usen la ruta de la API compatible con OpenAI de Roo Code, anota los datos operativos que hacen posible el soporte y la revisión de costos.
| Campo del manual de procedimientos | Registra esto |
|---|---|
| Alcance de Roo Code | Instalación local existente, imagen de equipo, perfil archivado o prueba solo para migración. |
| Clave de Flatkey | Propietario, entorno, fecha de rotación y propietario de la revocación. |
| URL base | La URL base exacta del proveedor guardada en Roo Code y la fecha en que se verificó. |
| Alias del modelo | ID del modelo de Roo Code, alias del modelo de Flatkey, familia de puntos de conexión y resultado de la llamada a la herramienta nativa. |
| Prueba de humo | Estado HTTP, motivo de finalización, uso total y si aparecieron tool_calls. |
| Revisión del uso | Donde los propietarios de la plataforma y de finanzas verifican el volumen de solicitudes, el costo y los cambios inesperados en el modelo. |
| Reversión | Configuración del proveedor anterior, alias del modelo anterior y quién puede restaurarlo. |
Ruta de migración interna
Si tu equipo está estandarizando las configuraciones de herramientas compatibles con OpenAI en Flatkey, mantén esta configuración alineada con el resto del clúster de integración. Usa la guía de migración de la API compatible con OpenAI como URL base y centro de reversión. Para otro patrón de cliente de escritorio, compara la guía de configuración de la API de Cherry Studio. Para el enrutamiento de agentes de codificación en las máquinas de los desarrolladores, revisa la guía de cc-switch Claude Code.
Después de que funcione la primera solicitud segura de Roo Code, revisa la página de precios de los modelos de Flatkey actual y, a continuación, obtén una clave para cada usuario, equipo o límite de entorno por separado.
Preguntas frecuentes
¿Roo Code sigue siendo compatible con los proveedores compatibles con OpenAI?
La documentación del proveedor compatible con OpenAI de Roo Code todavía describe los campos del proveedor: Proveedor de API, URL base, Clave de API e ID del modelo. La página principal de la documentación también dice que la extensión Roo Code se cerró el 15 de mayo de 2026, así que verifica tu ruta de instalación antes de una nueva implementación.
¿Qué URL base debo usar para el proveedor de la API compatible con OpenAI de Roo Code?
Usa la URL base actual del proveedor de Flatkey para tu cuenta. Las comprobaciones autenticadas de Flatkey de este artículo usaron https://router.flatkey.ai/v1, mientras que los ejemplos públicos pueden cambiar. En Roo Code, pega solo la URL base, no el punto de conexión completo de finalización de chat.
¿Por qué se requiere la llamada a herramientas nativas?
La documentación del proveedor de Roo Code dice que la llamada a herramientas nativas es el único protocolo de herramientas compatible con los proveedores compatibles con OpenAI. Un modelo que puede responder a un chat simple pero que no puede producir llamadas a herramientas al estilo de OpenAI no es suficiente para una configuración fiable de Roo Code.
¿Debe el ID del modelo coincidir exactamente con el alias del modelo de Flatkey?
Sí. Utilice el alias exacto de Flatkey al que su clave puede llamar y verifíquelo con una prueba de humo de llamada a herramientas. Los nombres de las familias de modelos, los nombres de marketing de los proveedores y los alias de las puertas de enlace pueden diferir.
¿Puedo usar esta guía para nuevas implementaciones de Roo Code?
Úsela solo después de comprobar la disponibilidad actual de Roo Code. Las comprobaciones de enrutamiento de Flatkey siguen siendo útiles, pero el aviso de cierre de Roo Code significa que las nuevas implementaciones para todo el equipo necesitan una decisión explícita de soporte del producto.
Conclusión
Una configuración segura de la API compatible con OpenAI de Roo Code a través de Flatkey debe demostrar más que una respuesta de chat exitosa. Confirme la URL base actual, use una clave propiedad de Flatkey, seleccione un alias de modelo exacto, pruebe las llamadas a herramientas nativas y verifique la visibilidad del uso antes de dar a Roo Code acceso al trabajo de código real. Cuando la ruta esté lista para otro usuario o entorno, obtenga una clave y mantenga la fila de reversión junto a las instrucciones de configuración.
