PandaNpc almacena las conexiones de proveedores y las entradas de modelos que configures. Comienza con la clave de API, la URL base, el protocolo y el ID del modelo proporcionados por tu servicio. Agregar una entrada no crea una cuenta en el proveedor ni otorga acceso al modelo.
Para conocer la diferencia entre un proveedor y un modelo, consulta Administra tu lista de modelos personalizados.
Antes de empezar
Confirma lo siguiente con tu proveedor o servicio autoalojado:
- La dirección base de la API, no la dirección del sitio web del proveedor.
- El método de autenticación y las credenciales requeridas.
- El protocolo de API compatible con la funcionalidad o el motor que planeas usar.
- El ID de modelo exacto que tu cuenta puede usar.
- Los límites de contexto y de salida si planeas introducirlos manualmente.
Mantén las credenciales en el formulario del proveedor, no en indicaciones, capturas de pantalla ni notas compartidas. Un servicio que se anuncia como compatible con OpenAI puede diferir en cuanto a streaming, llamadas a herramientas o soporte de imágenes.
1. Agregar o configurar un proveedor
Abre Configuración de modelos. Agrega un proveedor, configura un ajuste preestablecido existente o copia un ajuste preestablecido cuando necesites una conexión editable de forma independiente.
| Campo | Qué introducir |
|---|---|
| Nombre para mostrar | Un nombre reconocible para esta conexión |
| ID de proveedor | Un identificador para la configuración del proveedor |
| Clave API | La credencial que requiere tu servicio |
| URL base | La dirección base de la API que espera la integración elegida |
| Protocolo | El formato que implementa realmente la API del proveedor |
| Secreto, Organización, Proyecto | Solo los valores que tu servicio requiera explícitamente |
| Admitir array de contenido | Si el servicio acepta contenido estructurado de mensajes |
La forma de la URL base depende del protocolo y de la funcionalidad que realiza las solicitudes. No agregues una ruta de operación completa si la integración ya la agrega. Por ejemplo, una integración que agrega /chat/completions necesita la dirección base correspondiente, no una dirección que ya termine con esa ruta. No apliques ese ejemplo a todos los protocolos.
Al editar credenciales guardadas, dejar en blanco la Clave API o el Secreto conserva el valor configurado. Un valor enmascarado que se muestra en una lista no es la clave original y no debe pegarse de nuevo como reemplazo.
2. Agregar el modelo
Guarda el proveedor, selecciónalo y elige Agregar modelo.
| Campo | Significado |
|---|---|
| Nombre para mostrar | Tu etiqueta en la lista de modelos |
| Valor del modelo | El ID de modelo exacto del proveedor |
| Tipo de modelo | La categoría aplicable en el formulario de configuración |
| Proveedor | La conexión que usa esta entrada |
| Ventana de contexto | La capacidad de contexto documentada, cuando se especifica |
| Máximo de tokens | El límite de salida, cuando se especifica |
Usa un ID de la documentación o de la lista de modelos del servicio. Un nombre comercial no es necesariamente un identificador de API. Deja sin definir los límites opcionales si no puedes verificarlos; que no estén definidos no significa que se hayan detectado los límites reales. La funcionalidad consumidora puede aplicar sus propios valores predeterminados.
3. Verificar la configuración
En la funcionalidad o el motor que utiliza estos ajustes:
- Selecciona la nueva entrada y comienza una conversación de prueba.
- Envía una solicitud breve como
Reply with: connected. - Confirma una respuesta normal y, si está disponible, una solicitud correspondiente en los registros de uso del proveedor.
- Envía un mensaje de seguimiento para comprobar la continuidad de la conversación.
- Prueba las imágenes o las llamadas a herramientas por separado si tu trabajo lo requiere.
Guardar el registro no es una prueba de conexión. Una respuesta de texto no establece la compatibilidad con todas las capacidades. Cambiar una entrada de modelo tampoco reconfigura automáticamente un proceso existente de Claude Code o Codex; consulta PandaPaw.
Solución de problemas
La autenticación falla
Comprueba si la clave está activa, si la cuenta puede acceder al modelo y si el servicio requiere campos de autenticación adicionales. Reemplaza las credenciales vencidas mediante el formulario del proveedor.
No se encuentra el endpoint ni el modelo
Comprueba tanto la URL base como el valor del modelo. Busca rutas de operación duplicadas, un prefijo de API faltante o un ID de modelo no disponible para tu cuenta. El mismo error puede tener causas diferentes en distintos proveedores.
Aparece un error de red o del navegador
Comprueba la conectividad desde el dispositivo que realmente envía la solicitud. Las solicitudes originadas en el navegador están sujetas a las restricciones de CORS y HTTPS; que una solicitud funcione desde otra computadora no demuestra que la ruta del navegador funcione.
No se puede acceder a un servidor de modelos local
localhost se refiere a la máquina que realiza la solicitud. No apunta automáticamente a tu computadora remota con PandaPaw. Confirma dónde se ejecuta la funcionalidad que utiliza estos ajustes antes de elegir la dirección de tu servidor local.
El texto funciona, pero las imágenes, las herramientas o las sesiones largas fallan
Comprueba la combinación exacta de motor, protocolo de API y capacidades del modelo. Usa límites admitidos por el proveedor y verifica cada tipo de entrada necesario. Aumentar la Ventana de contexto o cambiar el Tipo de modelo no agrega capacidades del proveedor.
Para la diferencia entre la membresía de la plataforma y el uso del proveedor, consulta cuentas y costos de modelos.