Conecta un proveedor de modelos
Configura el tipo de API, endpoint, clave de API e identificador del modelo; entiende cómo Yenpo construye la URL y resuelve errores habituales.
AI Reader usa el proveedor seleccionado en Settings. Tu cuenta con el proveedor determina qué modelos puedes usar y cuánto pagas. Leer y buscar archivos no requiere esta conexión.
Añade un proveedor
Abre Settings → Models, pulsa Add Provider (el botón de suma) y selecciona la nueva entrada como Current provider. Ponle un nombre reconocible, como «Pasarela del equipo». Es solo una etiqueta y no afecta a la API utilizada.
Completa estos campos:
| Campo | Qué introducir |
|---|---|
| API type | El protocolo del servicio: OpenAI Chat Completions, OpenAI Responses o Anthropic Messages |
| Endpoint | La URL del servicio, incluido cualquier prefijo de ruta que requiera la pasarela |
| Authentication / API key | Tu clave de API o la opción de inicio de sesión del proveedor |
| Model | El identificador exacto del modelo al que tiene acceso tu cuenta |
Introduce las claves de API únicamente en Settings, nunca en una conversación ni en un archivo del proyecto. Algunos proveedores permiten iniciar sesión con una cuenta en lugar de usar una clave; si el tuyo lo ofrece, selecciónalo en Sign-in method.
Haz coincidir el endpoint con el tipo de API
El nombre del modelo no determina el protocolo: una pasarela puede servir nombres de modelo parecidos mediante API diferentes. Sigue la documentación de API del servicio y conserva los prefijos de ruta necesarios.
Estas URL muestran cómo Yenpo construye la dirección de la solicitud. Son ejemplos, no servicios operativos:
| Tipo de API | Campo Endpoint de ejemplo | URL de solicitud resultante |
|---|---|---|
| Chat Completions | https://gateway.example/v1 |
https://gateway.example/v1/chat/completions |
| Responses | https://gateway.example |
https://gateway.example/v1/responses |
| Messages | https://gateway.example |
https://gateway.example/v1/messages |
Si el endpoint ya termina en /chat/completions, /responses o /messages, Yenpo lo usa tal cual para el tipo de API correspondiente. Para Responses y Messages, añade el último segmento a los endpoints que terminan en /v1. Chat Completions siempre añade /chat/completions a lo que introduzcas y no añade un /v1 que falte.
Ante un error, no alternes entre tipos de API hasta que desaparezca. Averigua qué protocolo admite el servicio y cuál debe ser la ruta completa.
Identificador del modelo
Escribe el identificador en Model o pulsa Fetch List si el servicio publica una lista de modelos. Obtener la lista y llamar al modelo son solicitudes distintas; el modelo puede funcionar aunque falle la lista. Prueba a introducir directamente el identificador documentado.
Context length afecta a los presupuestos de entrada y salida de Yenpo, al momento en que se compacta la conversación y a cuánto contexto se conserva después. Introduce el límite documentado del modelo; dejarlo vacío usa el valor por defecto de Yenpo. Un valor demasiado pequeño puede provocar compactaciones innecesarias; uno demasiado grande puede generar solicitudes que el modelo rechace.
Pricing sirve para calcular el coste estimado mostrado en los detalles de ejecución. Usa las tarifas de tu proveedor; estos valores no cambian los cargos reales ni conceden acceso a modelos. Mientras consigues que funcione la primera conexión, deja los demás ajustes como están.
La entrada de imágenes está desactivada por defecto para cada proveedor. Activa Accept images solo si el modelo y la API admiten las imágenes que piensas enviar.
Prueba con una pregunta pequeña
Abre un archivo pequeño que tengas permiso para enviar a este servicio y pregunta:
¿Qué devuelve esta función con una entrada vacía? Cita la rama relevante.
Si recibes una respuesta, la conexión funciona. Que la respuesta sea correcta es otra cuestión: compruébala en el código.
Una solicitud contiene tu mensaje y el código relevante que AI Reader encuentra en el proyecto, no solo lo que escribiste. Lee Datos, permisos de edición y terminal antes de enviar código confidencial a un endpoint remoto.
Si falla una solicitud
| Síntoma | Qué comprobar |
|---|---|
| Error de autenticación o permisos | La cuenta o clave seleccionada, el propietario del endpoint y el acceso al modelo |
| No encontrado o API no compatible | El tipo de API y la ruta completa, incluidos los prefijos de la pasarela |
| Modelo no encontrado | El identificador exacto y si tu cuenta puede usarlo |
| Falla Fetch Models | Si el servicio publica modelos; introduce directamente el identificador documentado |
| Tiempo de espera agotado o flujo interrumpido | Acceso a la red, comportamiento del proxy o pasarela y disponibilidad del proveedor |
Un estado HTTP aislado rara vez explica la causa, y las pasarelas pueden reescribir errores del servicio de origen. Al informar de un problema, incluye el mensaje de error, el tipo de API y el endpoint con los datos privados eliminados. Nunca incluyas la clave de API.
Si se interrumpió una ejecución con permiso de edición, comprueba el árbol de trabajo antes de reintentar. Los archivos pueden haber cambiado aunque no haya llegado una respuesta final.