Claves API de plataformas oficiales
BYOK significa usar tu propia cuenta de proveedor y tu clave API para acceder a los modelos. La clave se configura en local en Mystilink y el consumo lo factura el proveedor. Si quieres usar la cuenta y el saldo de Mystilink, consulta Newton LLM; no hace falta añadir aquí una clave externa.
Preparar tres datos
- Clave API: generada en la plataforma de desarrolladores del proveedor que expone realmente la API; no pongas una contraseña web, una clave de activación de Mystilink ni credenciales de un producto de chat.
- ID de modelo: un identificador al que la cuenta API actual tenga derecho; el nombre visible no siempre es el ID usado.
- Permisos y cupo de API: poder iniciar sesión en la web de chat del proveedor no significa que la cuenta tenga cupo de API. Compruébalo en la plataforma de desarrolladores.
No des por hecho que los nombres de modelos antiguos de ejemplos de internet están disponibles. Elige de la lista actual y revisa letra por letra al escribir a mano.
Añadir en Mystilink
Abre Ajustes → Modelos grandes y elige el proveedor correspondiente al servicio. Rellena la clave API o, según lo que permita la interfaz, el nombre de una variable de entorno local. Con un servicio oficial, mantén la URL del modelo por defecto; sobrescribe la URL base solo si necesitas explícitamente un proxy u otro punto de acceso.
Prueba primero la conexión, luego escribe o elige el ID de modelo, completa el nombre visible y guarda. Tras definir la configuración como modelo principal, confirma con un mensaje sin datos privados que la conversación termina. Un test de conexión correcto no garantiza todas las capacidades de llamada a herramientas del Agent.
Proveedores y protocolos
Estos son los proveedores y entradas oficiales correspondientes en Mystilink; no es una promesa de regiones, modelos o precios disponibles. La obtención de claves, los permisos y las reglas de pago siguen la plataforma del proveedor.
| Proveedor | Entrada oficial | Nota sobre la plantilla de Mystilink |
|---|---|---|
| OpenAI | Plataforma API, Guía de autenticación | Plantilla OpenAI; mantén la URL por defecto y elige un modelo accesible para la cuenta |
| Anthropic | Console, Documentación API | La API nativa usa el protocolo Anthropic; no la introduzcas como pasarela compatible genérica |
| Google Gemini | AI Studio, Documentación de modelos | Plantilla Gemini; la plantilla actual no permite sobrescribir la URL base |
| DeepSeek | Plataforma, Documentación API | Plantilla DeepSeek; comprueba el modelo y los permisos de la cuenta |
| MiniMax | Plataforma | Plantilla correspondiente; no mezcles cuentas, claves y URL de regiones distintas |
| Moonshot / Kimi | Plataforma | Plantilla correspondiente; el ID de modelo y la URL deben venir de la misma región y cuenta |
Anthropic
Con el servicio nativo oficial elige la plantilla Anthropic. Si el proveedor ofrece además una pasarela compatible, usa el protocolo y la URL compatibles que publique; no elijas la plantilla nativa solo porque el nombre del modelo contenga Claude.
Google Gemini
Usa la plantilla Gemini para la API nativa oficial. Los modelos Gemini de plataformas externas pueden usar otro protocolo compatible: elige Proveedor personalizado según la pasarela real.
URL, clave y modelo deben venir del mismo servicio
Una clave oficial no siempre sirve para un proxy, y una clave de proxy no se pone directamente en una URL oficial. Comprueba a la vez: quién emitió la clave, a qué dominio va la solicitud y qué modelos puede usar esa cuenta. Tras sobrescribir la URL, el contenido de la solicitud va al servicio de la nueva dirección.
La URL base debe llevar el prefijo API del servicio; no pegues una ruta completa de solicitud de chat ni una página de detalle de modelo. Para una pasarela externa o un servicio local, consulta Proveedores compatibles y Modelo local.
Problemas habituales
| Síntoma | Qué revisar primero |
|---|---|
| 401 / clave inválida | Si la clave corresponde a la URL actual, si caducó o se revocó, y si la app puede leer la variable de entorno |
| Lista de modelos vacía | Permisos de la cuenta, soporte de descubrimiento; con un ID exacto se puede escribir a mano |
| 404 / model not found | Prefijo API e ID de modelo; ¿se tomó el nombre visible como ID? |
| Test correcto pero tarea sin terminar | Llamada a herramientas, salida en streaming y capacidades del modelo, no solo la red |
| Error de cupo | Revisa la facturación API en el proveedor; recargar Newton no añade cupo externo |
Para más diagnóstico: Problemas de conexión con modelos grandes. Si la clave se filtra, revócala en la plataforma emisora y vuelve a configurar; cambiar el nombre visible o borrar una captura no basta.