Si está configurando el proveedor de la API compatible con OpenAI de Cline, los campos visibles son simples: URL base, clave de API e ID del modelo. El riesgo de producción es menos obvio. Una ruta incorrecta, un alias de modelo obsoleto, una capacidad de modelo no verificada o una clave que no le pertenece pueden hacer que Cline falle solo después de que un desarrollador comience a depender de él dentro de VS Code.
Esta guía muestra una configuración práctica de Flatkey para desarrolladores, equipos de productos de IA, creadores de automatización, ingenieros de plataforma, operadores financieros y revisores de adquisiciones que desean que Cline utilice una única ruta de Flatkey compatible con OpenAI en lugar de credenciales separadas de proveedor de modelos. Cubre los campos de Cline, las comprobaciones de la URL base de Flatkey, una prueba `curl` preliminar, la verificación, los modos de fallo y la transferencia de uso.
Nota sobre la fuente: esto se verificó el 29 de junio de 2026 con la documentación oficial del proveedor compatible con OpenAI de Cline, la documentación oficial de configuración de administrador compatible con OpenAI de Cline y las páginas públicas de Flatkey en vivo. No se disponía de una clave de Flatkey específica de una cuenta ni de un espacio de trabajo de Cline para una prueba de humo en vivo de Cline, por lo que los fragmentos de solicitud a continuación son plantillas para ejecutar con su propia clave y alias de modelo.
Respuesta rápida: Configuración de la API compatible con OpenAI de Cline
Para una configuración de la API compatible con OpenAI de Cline con Flatkey, elija Compatible con OpenAI como proveedor de API de Cline, utilice la URL base actual de Flatkey, pegue una clave de API de Flatkey e introduzca un alias de modelo de Flatkey exacto como ID del modelo. Luego, verifique con una pequeña instrucción antes de habilitar una configuración de modelo más avanzada.
| Campo de Cline | Valor de Flatkey | Comprobación de revisión |
|---|---|---|
| Proveedor de API | Compatible con OpenAI | Utilice este proveedor para Flatkey, no el proveedor oficial de OpenAI, porque Flatkey es el punto de conexión compatible. |
| URL base | https://console.flatkey.ai/v1 cuando este sea el valor actual que se muestra para su cuenta de Flatkey |
Utilice la URL base, no la ruta completa /chat/completions. Copie el valor en vivo de Flatkey antes de la producción. |
| Clave de API | Una clave de Flatkey propiedad del desarrollador, equipo o entorno | No pegue claves de proveedores ascendentes en Cline si Flatkey está destinado a ser la puerta de enlace. |
| Modelo | El alias de modelo exacto de Flatkey habilitado para esa cuenta | Los nombres de los modelos son específicos del proveedor. Utilice el alias que Flatkey espera, no un nombre de familia de proveedor genérico. |
| Configuración del modelo | Ajustes de contexto, token de salida, imagen, uso de computadora y precio solo después de que el chat básico funcione | No marque las capacidades como disponibles hasta que se haya probado la ruta de Flatkey y el alias de modelo seleccionados. |
Ese es el camino corto. El resto de esta guía de la API compatible con OpenAI de Cline trata sobre cómo hacer que la configuración sea lo suficientemente repetible para los equipos: primero probar el transporte, luego probar el alias del modelo y después documentar la ruta que revisarán los responsables de finanzas y de la plataforma.
Lo que confirman los documentos actuales de Cline
La página oficial del proveedor compatible con OpenAI de Cline dice que Cline admite proveedores que exponen API compatibles con el estándar de la API de OpenAI, incluidos modelos locales, proveedores en la nube y cualquier otro punto de conexión compatible con OpenAI. También dice que la página Compatible con OpenAI es para proveedores distintos de la API oficial de OpenAI, que tiene su propia página de configuración.
Para esta integración, los campos importantes de Cline son directos. Cline documenta la URL base, la clave de API y el ID del modelo como la configuración principal. En el panel de configuración de Cline, el flujo documentado es seleccionar Compatible con OpenAI, introducir la URL base del proveedor, introducir la clave de API y elegir o introducir el ID del modelo. La misma página enumera campos de configuración de modelo avanzados como tokens de salida máximos, tamaño de la ventana de contexto, soporte de imágenes, uso de computadora, precio de entrada y precio de salida.
La sección oficial de solución de problemas también es útil para la configuración de Flatkey. Cline señala errores de clave de API no válida, modelo no encontrado, errores de conexión y resultados inesperados. Esos son los mismos cuatro primeros errores que hay que diferenciar cuando una ruta de la API compatible con OpenAI de Cline falla a través de una puerta de enlace.
Valores de Flatkey a confirmar antes de abrir Cline
Realice estas comprobaciones antes de pegar nada en Cline. Mantienen la configuración vinculada al estado actual de la cuenta de Flatkey en lugar de a un ejemplo copiado.
1. Confirme la URL base actual de Flatkey
La página de inicio de Flatkey, comprobada 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. La misma página pública muestra ejemplos al estilo de OpenAI que utilizan https://console.flatkey.ai/v1 y https://console.flatkey.ai/v1/chat/completions.
Para Cline, utilice el valor de la URL base en el campo URL base. No pegue la URL completa de finalización de chat en Cline. Si un valor futuro de la consola de Flatkey difiere, utilice el valor que muestra Flatkey para su cuenta y conserve el valor que funciona en su manual de procedimientos.
2. Confirme el alias del modelo y la familia de puntos de conexión
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.
Utilice estos datos como evidencia pública fechada de la estructura del catálogo, no como una garantía de que su clave de Flatkey pueda llamar a todos los modelos o endpoints. Para el proveedor de la API de Cline compatible con OpenAI, elija un alias de modelo que sea compatible con la ruta de chat compatible con OpenAI y el conjunto de capacidades esperado de Cline.
3. Confirme quién es el propietario de la clave
Cline se ejecuta dentro de un flujo de trabajo de desarrollador, por lo que las claves personales son tentadoras. Para una ruta de equipo de producción, utilice una clave de Flatkey que pertenezca al usuario, equipo o entorno correcto. Registre quién puede rotarla, a qué alias de modelo debe llegar y qué usuarios u organizaciones de Cline dependen de ella.
Paso a paso: configurar Cline con Flatkey
- Abra la configuración de Cline. En la extensión de Cline, abra el panel de configuración desde el icono de engranaje.
- Seleccione OpenAI Compatible. En Proveedor de API, elija OpenAI Compatible. Este es el tipo de proveedor de Cline para una ruta compatible con OpenAI de Flatkey.
- Establezca la URL base. Ingrese la URL base actual de Flatkey, por ejemplo
https://console.flatkey.ai/v1cuando ese sea el valor que se muestra para su cuenta. - Pegue la clave de API de Flatkey. Utilice una clave de Flatkey para el usuario, equipo o entorno. Manténgala fuera de los prompts, archivos de repositorio, comentarios de incidencias y capturas de pantalla.
- Establezca el modelo. Ingrese el alias de modelo exacto de Flatkey. Si Cline muestra un selector, verifique de todos modos que el alias elegido esté aprobado para esta carga de trabajo.
- Mantenga una configuración de modelo avanzada conservadora. Comience con un valor pequeño de tokens de salida máximos y una ventana de contexto conocida. Active el soporte de imágenes o los indicadores de capacidad de estilo de uso de computadora solo después de que la ruta seleccionada los demuestre.
- Verifique la conexión. Utilice el flujo de verificación de Cline cuando esté disponible, luego ejecute un pequeño prompt de Cline que no toque el código de producción ni los secretos.
- Compruebe la visibilidad del uso de Flatkey. Después de un prompt de Cline exitoso, revise el uso de Flatkey para la clave, el alias del modelo y la marca de tiempo. Este es el punto de transferencia para los revisores de finanzas y de la plataforma.
- Anote la reversión. Registre la configuración anterior del proveedor de Cline o el alias del modelo que funcionaba anteriormente antes de pedir a más desarrolladores que cambien.
Prueba preliminar de plantilla antes de la verificación de Cline
La forma más rápida de depurar una configuración de la API de Cline compatible con OpenAI es probar primero la ruta de Flatkey fuera de Cline. Si esta solicitud curl falla, corrija la clave, la URL base o el alias del modelo antes de cambiar la configuración de Cline.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_MODEL="replace-with-your-flatkey-model-alias"
curl https://console.flatkey.ai/v1/chat/completions \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_MODEL"'",
"messages": [
{"role": "user", "content": "Devolver una comprobación corta de enrutamiento de Cline."}
],
"max_tokens": 32
}'Si curl tiene éxito pero Cline falla, el problema probablemente sea el mapeo de campos del lado de Cline, un indicador de capacidad del modelo, el acceso a la red desde la máquina del desarrollador o el ID exacto del modelo guardado en Cline. Si curl falla, capture el código de estado y el cuerpo de la respuesta antes de editar Cline.
Modos de fallo a depurar primero
| Symptom | Likely cause | Fix |
|---|---|---|
| Clave de API no válida | La clave de Flatkey se copió incorrectamente, expiró, pertenece a otro entorno o se pegó en su lugar una clave de proveedor ascendente. | Rote o vuelva a crear la clave de Flatkey, vuelva a probar con curl y luego péguela en Cline. |
| Error de conexión | URL base incorrecta, falta de /v1, ruta de red bloqueada, problema de proxy o ruta de endpoint completa pegada en lugar de la URL base. |
Abra la URL base desde la misma máquina, vuelva a probar con curl y mantenga el campo de URL base de Cline en la ruta base del proveedor. |
| Modelo no encontrado | El ID del modelo de Cline no coincide con un alias de Flatkey habilitado para la clave o la familia de endpoints. | Copie el alias exacto de Flatkey desde la consola o la vista de precios/catálogo, luego vuelva a probar una solicitud de chat simple. |
| Resultados inesperados | Alias de modelo incorrecto, indicador de capacidad no compatible, ventana de contexto no coincidente o una ruta que se comporta de manera diferente a la forma esperada compatible con OpenAI. | Desactive las capacidades opcionales, reduzca los límites de tokens, pruebe el chat simple y luego vuelva a habilitar las opciones avanzadas una por una. |
| El uso no se puede conciliar | La configuración no registró el propietario de la clave, el usuario, el alias del modelo, el entorno o el espacio de trabajo de Cline. | Agregue una fila al manual de operaciones con el usuario u organización de Cline, el propietario de la clave de Flatkey, el alias del modelo, la familia de endpoints y la carga de trabajo esperada. |
Configuración empresarial de Cline con Flatkey
Para desarrolladores individuales, el flujo de configuración de VS Code es suficiente. Para equipos gestionados, la documentación de administración de Cline describe la configuración remota del proveedor a través de la consola de administración alojada. Los administradores pueden agregar un endpoint compatible con OpenAI como el proveedor de LLM para toda la organización, seleccionar OpenAI Compatible, configurar una URL base requerida, agregar encabezados personalizados opcionales y guardar la configuración para los miembros de la organización.
Esa ruta empresarial es útil cuando la ruta de la API de Cline compatible con OpenAI debe ser coherente en todo un equipo. Permite a los propietarios de la plataforma centralizar la configuración del proveedor mientras se siguen requiriendo las mismas comprobaciones de Flatkey: URL base actual, detalles de autenticación correctos, alias de modelo aprobados y verificación desde una cuenta de miembro.
| Decisión del equipo | Punto de partida recomendado | Por qué es importante |
|---|---|---|
| Configuración propiedad del desarrollador | Usa el panel de configuración de la extensión de Cline y una clave Flatkey de desarrollador o de equipo. | Es lo más rápido para una prueba piloto, pero cada desarrollador puede desviarse si la configuración no está documentada. |
| Configuración para toda la organización | Usa la configuración remota de proveedor de Cline y establece OpenAI Compatible como el proveedor obligatorio. | Mejor para equipos que necesitan una ruta Flatkey estándar, acceso consistente a los modelos y revisión centralizada. |
| Encabezados personalizados | Déjalo vacío a menos que Flatkey o tu capa de red los requieran explícitamente. | Los encabezados adicionales pueden ocultar el comportamiento del enrutamiento. Mantén simple la primera configuración que funcione. |
Manual de operaciones (runbook) de producción para Cline y Flatkey
Antes de que más desarrolladores usen la ruta de la API de Cline compatible con OpenAI, registra los siguientes detalles. El objetivo es hacer que los fallos, la revisión de costos y las reversiones (rollback) sean predecibles y sin sorpresas.
| Campo del runbook | Registra esto |
|---|---|
| Alcance de Cline | Desarrollador individual, equipo o configuración remota para toda la organización. |
| Clave Flatkey | Propietario, entorno, fecha de rotación y quién puede revocarla. |
| URL base | La URL base exacta guardada en Cline y la fecha en que se verificó. |
| Alias del modelo | El ID del modelo de Cline, el alias de Flatkey, la familia de endpoints y las capacidades esperadas. |
| Configuración de capacidades | Ventana de contexto, tokens máximos de salida, soporte de imágenes, comportamiento de uso de computadora/herramientas y cualquier campo de precios introducido en Cline. |
| Revisión de uso | Dónde el equipo revisa el volumen de solicitudes, el costo y los cambios inesperados en el modelo después del primer prompt en Cline. |
| Reversión (Rollback) | La configuración de proveedor anterior, el alias de modelo anterior y quién puede restaurarlo. |
Ruta de migración interna
Si tu equipo está estandarizando múltiples herramientas compatibles con OpenAI en Flatkey, mantén la configuración de Cline consistente con el resto del clúster de integración. Usa la guía de migración de API compatibles con OpenAI como el centro canónico para la migración de la URL base. Para otro patrón de cliente de escritorio, compara la guía de configuración de la API de Cherry Studio. Para el enrutamiento en la máquina del desarrollador con cambios de modelo, consulta la configuración de cc-switch Claude Code.
Después de que tu primer prompt en Cline funcione, revisa la página de precios de modelos de Flatkey actual, luego obtén una clave para cualquier usuario, equipo o entorno adicional que necesite un límite de credenciales separado.
Preguntas frecuentes
¿Qué URL base debo usar para el proveedor de API compatible con OpenAI de Cline?
Comienza con la URL base de Flatkey actual que se muestra para tu cuenta. El 29 de junio de 2026, la página de inicio pública de Flatkey mostraba https://console.flatkey.ai/v1 en ejemplos de estilo OpenAI. No pegues el endpoint completo /chat/completions en el campo de URL base de Cline.
¿El ID del modelo de Cline debe coincidir exactamente con el alias del modelo de Flatkey?
Sí, usa el alias de modelo de Flatkey exacto al que tu clave tiene permitido llamar. La documentación de Cline dice que los ID de modelo difieren según el proveedor compatible con OpenAI, así que no confíes en un nombre de familia genérico a menos que Flatkey exponga ese alias exacto.
¿Puedo usar el proveedor oficial de OpenAI en Cline con Flatkey?
Usa OpenAI Compatible para Flatkey. La documentación de OpenAI Compatible de Cline es específicamente para proveedores distintos de la API oficial de OpenAI que exponen un endpoint compatible con OpenAI.
¿Cline admite la configuración compatible con OpenAI a nivel de equipo?
Sí. La documentación de administración de Cline describe la configuración remota de proveedores donde un administrador puede configurar un endpoint compatible con OpenAI como el proveedor de LLM para toda la organización, incluyendo una URL base requerida y encabezados personalizados opcionales.
¿Por qué probar con curl antes de verificar en Cline?
Una prueba previa con curl separa los problemas de transporte de Flatkey de los problemas de los campos de Cline. Si curl falla, corrige primero la clave, la URL base o el alias del modelo. Si curl tiene éxito pero Cline falla, depura la configuración de Cline, los indicadores de capacidad, el acceso a la red y el ID del modelo guardado.
Conclusión
Una configuración fiable de la API de Cline compatible con OpenAI necesita más que pegar una clave. Confirma la URL base de Flatkey, usa el alias de modelo exacto, mantén las capacidades del modelo conservadoras hasta que el chat simple funcione, y deja un runbook que conecte el uso de Cline con la facturación de Flatkey y la revisión del enrutamiento. Cuando estés listo para estandarizar la ruta, obtén una clave y prueba el prompt más pequeño en Cline antes de trasladar el trabajo de codificación diario a ella.
