API Key personalizada en Cline
Conecta Cline en cuatro campos y separa los fallos de credencial, ruta y modelo.
Cline es el cliente de programación. El proveedor de API aporta el modelo, autentica la petición y factura los tokens. Una clave personalizada conecta ambas capas; no vuelve gratuito el uso del modelo ni evita las reglas de acceso del proveedor.
La configuración oficial OpenAI Compatible de Cline ofrece los campos necesarios: API Provider, Base URL, API Key y Model ID. Con OmniaKey, una clave permite usar los modelos Claude, GPT, Gemini, DeepSeek y otros que estén disponibles.
Comprobado el 11 de agosto de 2026. La documentación oficial de Cline confirma OpenAI Compatible, Base URL, API Key, Model ID y el flujo Verify. La disponibilidad y los precios cambian; copia los ID actuales del catálogo de OmniaKey.
Ajustes de la API key personalizada en Cline
Abre Cline en VS Code, entra en ajustes y completa:
| Campo | Valor |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.omniakey.com/v1 |
| API Key | La clave creada en el dashboard de OmniaKey |
| Model ID | Un ID exacto, por ejemplo gpt-5.6-terra |
El sufijo /v1 forma parte de la Base URL OpenAI-compatible. No uses solo el dominio ni añadas /chat/completions: Cline construye la ruta de la petición.
Configuración paso a paso
1. Crea una clave independiente
Inicia sesión en OmniaKey, añade saldo prepago y crea una API Key. Una clave exclusiva para Cline simplifica límites, rotación y auditoría frente a compartir la misma credencial con todas las herramientas.
No escribas la clave en código fuente, archivos del repositorio, issues o capturas. Pégala únicamente en el campo API Key de Cline.
2. Selecciona OpenAI Compatible
En API Provider elige OpenAI Compatible. No selecciones el proveedor oficial OpenAI si la clave pertenece a otro servicio: esa elección determina los campos y el endpoint que utiliza Cline.
3. Introduce la Base URL
Usa exactamente:
https://api.omniakey.com/v1
Errores habituales: omitir /v1, duplicarlo como /v1/v1 o introducir la ruta completa /v1/chat/completions.
4. Copia el Model ID exacto
Empieza por un modelo presente actualmente en el catálogo de OmniaKey:
| Model ID | Buen punto de partida |
|---|---|
claude-opus-5 | Trabajo difícil en repositorios que exige investigar a fondo |
gpt-5.6-terra | Programación diaria con equilibrio entre capacidad y coste |
gemini-3.1-pro-preview | Pruebas de contexto largo con la familia Gemini |
deepseek-v4-flash | Turnos de programación y agent más rápidos y económicos |
No son alias aproximados. Importan mayúsculas, guiones y sufijos de versión. Copia el ID en vez de escribirlo de memoria.
5. Verifica antes de editar
Si Cline muestra Verify para ese proveedor, úsalo. Después ejecuta una tarea estrecha y reversible:
Lee package.json e indica qué gestor de paquetes usa. No modifiques archivos.
Una verificación útil confirma:
- Cline aceptó la configuración del proveedor.
- El proveedor aceptó la API Key.
- El Model ID está disponible para esa clave.
- Una respuesta sencilla vuelve sin edición ni bucle de herramientas.
Después pasa a tareas que cambien el repositorio. La guía general de coding agents explica el flujo completo.
Cómo factura Cline BYOK
BYOK significa Bring Your Own Key. Cline envía peticiones con la configuración indicada y el proveedor factura el uso del modelo en esa cuenta. No convierte una API de pago en gratuita.
Revisa tokens de entrada, entrada en caché y salida, no solo la longitud de la respuesta visible. Un agent también consume contexto del repositorio, llamadas a herramientas y reintentos. La guía de facturación transparente explica por qué conviene comparar el coste por tarea aceptada.
Si aún no has elegido modelo, consulta la comparación de modelos para coding agents antes de optimizar Cline.
Cuando la API key de Cline no funciona
Invalid API Key o HTTP 401
Un 401 significa que el endpoint no aceptó la credencial. Comprueba que:
- la clave corresponde al mismo proveedor que la Base URL;
- no pegaste espacios antes o después;
- la clave sigue activa y no fue rotada o eliminada;
- la cuenta tiene saldo utilizable;
- Cline sigue configurado como
OpenAI Compatible.
Cambiar el Model ID no corrige un fallo de autenticación.
Model Not Found o HTTP 404
Un 404 puede indicar Base URL incorrecta o Model ID no disponible. Confirma primero que la URL termina una sola vez en /v1, y después copia el ID exacto del catálogo.
Si el endpoint funciona con otro modelo listado, la conexión es válida y el problema restante es el nombre o el acceso al modelo.
Error de conexión
Comprueba https://api.omniakey.com/v1 desde la misma máquina donde se ejecuta Cline. VPN, proxy, DNS, inspección TLS y firewall pueden afectar al IDE aunque el sitio abra en otro navegador.
No desactives TLS para ocultar un error de certificado. Corrige la red o la configuración de confianza.
Responde texto, pero fallan las herramientas
Una respuesta de texto solo prueba la generación básica. Cline necesita tool calls estructuradas para leer, editar y ejecutar comandos. Prueba una tarea de solo lectura antes de un cambio autónomo grande.
Si el modelo genera llamadas incorrectas de forma repetida, compara otro modelo preparado para trabajo agent en lugar de aumentar límites a ciegas.
El coste supera lo esperado
El contexto del repositorio puede dominar la factura aunque la respuesta final sea corta. Acota la tarea, excluye carpetas irrelevantes y compara coste por cambio aceptado.
Usa claves y caps separados para pruebas. Un cap limita la exposición financiera, pero no reduce los tokens de una tarea ineficiente.
Lista de seguridad
- Usa una clave exclusiva para Cline, no una credencial de producción.
- Define un cap proporcional al proyecto.
- Rota cualquier clave que aparezca en un repositorio, grabación, captura o issue.
- Revisa permisos antes de permitir comandos o edición.
- En repositorios nuevos o no fiables, comienza en solo lectura.
- Comprueba el registro de uso tras la primera sesión correcta.
La API Key controla el acceso al modelo. Los permisos de Cline controlan lo que el agent puede hacer en local. Son límites de seguridad distintos.
Preguntas frecuentes
¿Puedo usar mi propia API key con Cline?
Sí. Selecciona OpenAI Compatible e introduce Base URL, API Key y Model ID exacto de un proveedor compatible.
¿Una API key personalizada en Cline es gratis?
No. BYOK cambia quién autentica y factura la petición. El proveedor puede cobrar tokens de entrada, caché y salida.
¿Qué Base URL usa Cline con OmniaKey?
https://api.omniakey.com/v1. No añadas /chat/completions ni dupliques /v1.
¿Qué modelo conviene usar en Cline?
Empieza por un modelo vigente del catálogo. gpt-5.6-terra es una opción equilibrada; compara después resultados aceptados con modelos más fuertes o baratos.
¿Por qué Cline muestra Model Not Found?
Revisa Model ID y Base URL. Una clave válida puede no tener acceso a un modelo, y una URL mal formada también devuelve 404.
¿Cline guarda mi clave en el repositorio?
Las credenciales deben ir en los ajustes de Cline, no en archivos del proyecto. No copies la clave en código, prompts, capturas ni issues.