models.json. Este ejemplo usa BetterToken: configura la clave, la Base URL del protocolo y el Model ID. Para otro servicio, utiliza su URL, credenciales e identificadores de modelos.
Ajustes principales
Requisitos previos
- Node.js 22.19 o posterior.
- Crea una BetterToken API Key y elige un modelo con llamadas a herramientas en la model plaza.
- En Windows nativo, instala Git for Windows para la herramienta Bash de Pi, o ejecuta Pi en WSL.
Instalación
Usa el comando npm oficial actual de Pi:Configuración manual
Define la API Key
En la terminal desde la que iniciarás Pi, sustituyeYOUR_API_KEY por tu clave:
- macOS / Linux
- Windows PowerShell
Obtén modelos y genera la configuración
Haz clic en Obtener lista de modelos para consultar el catálogo público actual de BetterToken sin introducir una API Key. Elige una API y modelos compatibles con llamadas a herramientas; después copia un Model ID o descarga elmodels.json generado.
Si ya tienes un models.json, combina la entrada bettertoken generada con tu configuración en lugar de reemplazar el archivo. La configuración usa la variable $BETTERTOKEN_API_KEY definida arriba; añade otros parámetros según las capacidades reales del modelo.
Pi admite varios protocolos; elige uno compatible con el modelo y el servidor. Para esta conexión recomendamos Anthropic Messages para Claude, Responses para GPT cuando el servidor lo admita y Chat Completions para otros modelos compatibles con OpenAI. El selector usa Chat Completions por defecto y filtra por las API declaradas en el catálogo público. Si tu modelo no aparece en Responses, usa el ejemplo manual de abajo para modelos con soporte confirmado de Responses.
Añade la URL y el modelo
Crea~/.pi/agent/models.json. En Windows, la ruta predeterminada es %USERPROFILE%\.pi\agent\models.json. Si el archivo existe, incorpora la entrada bettertoken a su objeto providers.
Como alternativa a la configuración generada, completa manualmente este ejemplo de Responses API. Sustituye YOUR_MODEL_ID por un ID de la model plaza y conserva $BETTERTOKEN_API_KEY como referencia a la variable:
baseUrl y api con una pareja compatible:
Elige una API que permita llamar a herramientas con tu modelo. Por ejemplo, GPT-6.1 Sol usa Responses. Mantén la Base URL como se muestra; Pi añade la ruta de la solicitud.
Inicia Pi
Desde el directorio del proyecto, usa el Model ID configurado:Verificar la conexión
Ejecutapi --list-models y confirma que aparecen bettertoken y tu modelo. Después inicia Pi y envía:
PI_OK, prueba una tarea pequeña de solo lectura para verificar las llamadas a herramientas.
Cambiar de modelo
Añade entradas al arraymodels y ejecuta /model en Pi para recargar models.json. Selecciona un modelo y pulsa Ctrl+S para guardarlo como predeterminado de las sesiones nuevas. Usa nombres locales distintos para protocolos diferentes, cada uno con sus propios api y baseUrl.
Errores frecuentes
Configuración avanzada
Para imágenes, niveles de razonamiento o más contexto, defineinput, reasoning, contextWindow y maxTokens según las capacidades reales del modelo. Consulta la guía de selección de modelos.
Detalles técnicos
providers y --provider son campos de configuración de Pi; bettertoken es el nombre local de este ejemplo. Pi consulta primero --api-key, después las credenciales de auth.json y luego apiKey en models.json. Si ese nombre conserva credenciales antiguas, elimina la entrada correspondiente mediante /logout en Pi y vuelve a conectar.