Conectar un proveedor de IA
Preajustes, claves, la prueba de conexión y cómo interpretar los errores.
NovelKnow no está vinculado a ningún proveedor de modelos: tú traes tu propia clave de API, y qué modelo usas y cuánto te cuesta es decisión tuya.
La vía rápida
Ajustes de IA → haz clic en un preajuste de proveedor → pega tu clave → prueba la conexión → guarda.
El preajuste rellena la URL base, el modelo predeterminado y la ventana de contexto. Son las tres cosas con las que la gente se equivoca más a menudo y el motivo habitual por el que una configuración no funciona.
Preajustes integrados: DeepSeek, OpenRouter, OpenAI, Kimi / Moonshot, Qwen / DashScope, SiliconFlow y Ollama local.
Cualquier endpoint compatible con OpenAI funciona: elige la opción personalizada y escribe tú mismo la URL base.
Listas de modelos
Después de guardar, "Sincronizar modelos" obtiene la lista real de modelos del proveedor. A partir de entonces, los desplegables de modelos se rellenan con esa lista, de modo que nunca escribes un nombre de modelo a mano.
Marca como favoritos los que uses a menudo y se ordenarán arriba del todo.
Interpretar los errores
Las pruebas de conexión y los fallos de generación incluyen la propia respuesta del proveedor, para que puedas distinguir estos casos:
| El error contiene | Suele significar |
|---|---|
401 / Incorrect API key | Clave incorrecta o caducada |
404 / model does not exist | El nombre del modelo es incorrecto o tu cuenta no tiene acceso a él |
429 | Límite de peticiones alcanzado o la cuenta se ha quedado sin crédito |
fetch failed / ECONNREFUSED | El servidor no puede conectar con el proveedor; consulta la nota sobre el proxy más abajo |
Proxy de salida
Si tu despliegue no puede conectar con un proveedor, activa el proxy de salida en el diálogo de ajustes de IA.
Esa dirección se resuelve desde el servidor de despliegue, no desde tu propio ordenador. Apuntarla a 127.0.0.1:7890 solo tiene sentido si hay un proxy ejecutándose en el propio servidor.
Cómo se almacena tu clave
Las claves se cifran con una clave derivada de tu cuenta y solo se devuelven al navegador enmascaradas. No volverás a ver tu propia clave completa; para cambiarla, pega una nueva.