Proveedores de IA compatibles con Pi Agent
La siguiente es la lista completa de todos los proveedores de IA compatibles con Pi Agent.
Proveedores que admiten inicio de sesión por suscripción
Mediante/loginel comando para iniciar sesión con OAuth:
| Proveedor | Requisitos | Descripción |
|---|---|---|
| Claude Pro/Max | Suscripción de Anthropic | Uso adicional, facturado por token |
| ChatGPT Plus/Pro (Codex) | Suscripción de OpenAI | Reconocido oficialmente por OpenAI |
| GitHub Copilot | Suscripción de GitHub Copilot | Compatible con servidores empresariales |
| xAI (Grok) | Suscripción a X Premium | Usa modelos Grok |
| OpenRouter | Cuenta de OpenRouter | OAuth crea una API Key |
| Radius | Cuenta de Radius | Puerta de enlace dinámica pi-messages |
Las entradas de suscripción dependen de lo que realmente muestre el menú /login de Pi Agent; pueden variar ligeramente entre versiones.
Proveedores que admiten API Key
Mediante variables de entorno o~/.pi/agent/auth.jsonconfigurar la API Key:
$ export ANTHROPIC_API_KEY=sk-ant-api03-xxxx
| Proveedor | Variable de entorno | Clave de auth.json |
|---|---|---|
| Anthropic | ANTHROPIC_API_KEY | anthropic |
| Ant Ling | ANT_LING_API_KEY | ant-ling |
| Azure OpenAI Responses | AZURE_OPENAI_API_KEY | azure-openai-responses |
| OpenAI | OPENAI_API_KEY | openai |
| DeepSeek | DEEPSEEK_API_KEY | deepseek |
| NVIDIA NIM | NVIDIA_API_KEY | nvidia |
| Google Gemini | GEMINI_API_KEY | |
| Amazon Bedrock | AWS_BEARER_TOKEN_BEDROCK | amazon-bedrock |
| Mistral | MISTRAL_API_KEY | mistral |
| Groq | GROQ_API_KEY | groq |
| Cerebras | CEREBRAS_API_KEY | cerebras |
| Cloudflare AI Gateway | CLOUDFLARE_API_KEY (también requiere CLOUDFLARE_ACCOUNT_ID y CLOUDFLARE_GATEWAY_ID) | cloudflare-ai-gateway |
| Cloudflare Workers AI | CLOUDFLARE_API_KEY (también requiere CLOUDFLARE_ACCOUNT_ID) | cloudflare-workers-ai |
| xAI | XAI_API_KEY | xai |
| OpenRouter | OPENROUTER_API_KEY | openrouter |
| Vercel AI Gateway | AI_GATEWAY_API_KEY | vercel-ai-gateway |
| ZAI Coding Plan | ZAI_API_KEY | zai |
| ZAI Coding Plan (China) | ZAI_CODING_CN_API_KEY | zai-coding-cn |
| OpenCode Zen | OPENCODE_API_KEY | opencode |
| OpenCode Go | OPENCODE_API_KEY | opencode-go |
| Radius | RADIUS_API_KEY | radius |
| Hugging Face | HF_TOKEN | huggingface |
| Fireworks | FIREWORKS_API_KEY | fireworks |
| Together AI | TOGETHER_API_KEY | together |
| Baseten | BASETEN_API_KEY | baseten |
| Kimi For Coding | KIMI_API_KEY | kimi-coding |
| MiniMax | MINIMAX_API_KEY | minimax |
| MiniMax (China) | MINIMAX_CN_API_KEY | minimax-cn |
| Qwen Token Plan | QWEN_TOKEN_PLAN_API_KEY | qwen-token-plan |
| Qwen Token Plan(Individual) | QWEN_TOKEN_PLAN_API_KEY | qwen-token-plan-individual |
| Qwen Token Plan (China) | QWEN_TOKEN_PLAN_CN_API_KEY | qwen-token-plan-cn |
| Xiaomi MiMo | XIAOMI_API_KEY | xiaomi |
| Xiaomi MiMo Token Plan (China) | XIAOMI_TOKEN_PLAN_CN_API_KEY | xiaomi-token-plan-cn |
| Xiaomi MiMo Token Plan (Ámsterdam) | XIAOMI_TOKEN_PLAN_AMS_API_KEY | xiaomi-token-plan-ams |
| Xiaomi MiMo Token Plan (Singapur) | XIAOMI_TOKEN_PLAN_SGP_API_KEY | xiaomi-token-plan-sgp |
Hay 35 proveedores de API Key en total, correspondientes uno a uno con la lista de variables de entorno del providers.md oficial.
Entre ellos, Qwen Token Plan (Individual) y Qwen Token Plan comparten la misma variable de entorno QWEN_TOKEN_PLAN_API_KEY; la diferencia radica en el nombre de la clave en auth.json y el rango de modelos disponibles.
La cuenta y el ID de puerta de enlace de los dos elementos de Cloudflare se pueden configurar como variables de entorno o escribirse en el objeto env de las credenciales en auth.json.
Proveedores locales y personalizados
Los backends de inferencia local se integran mediante el archivo de configuración, mientras que las interfaces personalizadas se pueden registrar mediante extensiones.
| Proveedor | Descripción | Método de configuración |
|---|---|---|
| llama.cpp | Inferencia con modelos locales de código abierto | /login llama.cpp, los modelos se gestionan mediante /llama |
| API personalizada | Desarrollo de extensiones | Registrar mediante pi.registerProvider() |
Para un ejemplo completo de cómo registrar un proveedor mediante extensiones, consulte el capítulo «Local con modelos llama.cpp».
Los tres backends locales siguientes se conectan a través de la API compatible con OpenAI:
| Backend | Puerto predeterminado | Descripción |
|---|---|---|
| Ollama | 11434 | Listo para usar, con un solo comando se puede descargar y ejecutar un modelo |
| LM Studio | 1234 | Proporciona interfaz gráfica, adecuada para gestionar modelos locales en el escritorio |
| vLLM | 8000 | Orientado a despliegues de servicios de alto rendimiento |
Escriba el siguiente ejemplo mínimo en~/.pi/agent/models.json, tomando Ollama como ejemplo; para LM Studio y vLLM solo necesita reemplazar el nombre y la baseUrl:
Ejemplos
"providers": {
"ollama": {
"baseUrl": "http://127.0.0.1:11434/v1",
"api": "openai-completions",
"apiKey": "ollama",
"models": [
{
"id": "qwen3-coder-30b",
"name": "Qwen3 Coder 30B",
"contextWindow": 131072,
"maxTokens": 8192,
"input": ["text"]
}
]
}
}
}
El valor apiKey "ollama" en el ejemplo es solo un marcador de posición; el servidor local lo ignorará directamente.
Pero no lo elimine por eso: si no se configura ningún campo de autenticación, el modelo se carga normalmente, pero no aparece en el selector /model; además, la documentación oficial recomienda mantener el valor de marcador de posición.
El significado de los campos, excepto apiKey, es el siguiente:
| Campo | Descripción |
|---|---|
| baseUrl | Dirección de la API compatible con OpenAI; para LM Studio es http://127.0.0.1:1234/v1, para vLLM complete según la dirección real del servicio. |
| api | Usa el protocolo compatible con OpenAI; debe escribirse fijo como openai-completions |
| apiKey | Valor de marcador de posición; debe conservarse incluso si el servicio local no requiere autenticación, de lo contrario el modelo no aparecerá en /model |
| models[].id | ID del modelo utilizado al llamar; debe coincidir con el nombre del modelo descargado localmente |
| models[].name | Nombre mostrado en el selector |
| models[].contextWindow | Tamaño de la ventana de contexto (tokens) |
| models[].maxTokens | Longitud máxima de salida por solicitud (tokens) |
| models[].input | Tipos de entrada compatibles |