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:

ProveedorRequisitosDescripción
Claude Pro/MaxSuscripción de AnthropicUso adicional, facturado por token
ChatGPT Plus/Pro (Codex)Suscripción de OpenAIReconocido oficialmente por OpenAI
GitHub CopilotSuscripción de GitHub CopilotCompatible con servidores empresariales
xAI (Grok)Suscripción a X PremiumUsa modelos Grok
OpenRouterCuenta de OpenRouterOAuth crea una API Key
RadiusCuenta de RadiusPuerta 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
ProveedorVariable de entornoClave de auth.json
AnthropicANTHROPIC_API_KEYanthropic
Ant LingANT_LING_API_KEYant-ling
Azure OpenAI ResponsesAZURE_OPENAI_API_KEYazure-openai-responses
OpenAIOPENAI_API_KEYopenai
DeepSeekDEEPSEEK_API_KEYdeepseek
NVIDIA NIMNVIDIA_API_KEYnvidia
Google GeminiGEMINI_API_KEYgoogle
Amazon BedrockAWS_BEARER_TOKEN_BEDROCKamazon-bedrock
MistralMISTRAL_API_KEYmistral
GroqGROQ_API_KEYgroq
CerebrasCEREBRAS_API_KEYcerebras
Cloudflare AI GatewayCLOUDFLARE_API_KEY (también requiere CLOUDFLARE_ACCOUNT_ID y CLOUDFLARE_GATEWAY_ID)cloudflare-ai-gateway
Cloudflare Workers AICLOUDFLARE_API_KEY (también requiere CLOUDFLARE_ACCOUNT_ID)cloudflare-workers-ai
xAIXAI_API_KEYxai
OpenRouterOPENROUTER_API_KEYopenrouter
Vercel AI GatewayAI_GATEWAY_API_KEYvercel-ai-gateway
ZAI Coding PlanZAI_API_KEYzai
ZAI Coding Plan (China)ZAI_CODING_CN_API_KEYzai-coding-cn
OpenCode ZenOPENCODE_API_KEYopencode
OpenCode GoOPENCODE_API_KEYopencode-go
RadiusRADIUS_API_KEYradius
Hugging FaceHF_TOKENhuggingface
FireworksFIREWORKS_API_KEYfireworks
Together AITOGETHER_API_KEYtogether
BasetenBASETEN_API_KEYbaseten
Kimi For CodingKIMI_API_KEYkimi-coding
MiniMaxMINIMAX_API_KEYminimax
MiniMax (China)MINIMAX_CN_API_KEYminimax-cn
Qwen Token PlanQWEN_TOKEN_PLAN_API_KEYqwen-token-plan
Qwen Token Plan(Individual)QWEN_TOKEN_PLAN_API_KEYqwen-token-plan-individual
Qwen Token Plan (China)QWEN_TOKEN_PLAN_CN_API_KEYqwen-token-plan-cn
Xiaomi MiMoXIAOMI_API_KEYxiaomi
Xiaomi MiMo Token Plan (China)XIAOMI_TOKEN_PLAN_CN_API_KEYxiaomi-token-plan-cn
Xiaomi MiMo Token Plan (Ámsterdam)XIAOMI_TOKEN_PLAN_AMS_API_KEYxiaomi-token-plan-ams
Xiaomi MiMo Token Plan (Singapur)XIAOMI_TOKEN_PLAN_SGP_API_KEYxiaomi-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.

ProveedorDescripciónMétodo de configuración
llama.cppInferencia con modelos locales de código abierto/login llama.cpp, los modelos se gestionan mediante /llama
API personalizadaDesarrollo de extensionesRegistrar 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:

BackendPuerto predeterminadoDescripción
Ollama11434Listo para usar, con un solo comando se puede descargar y ejecutar un modelo
LM Studio1234Proporciona interfaz gráfica, adecuada para gestionar modelos locales en el escritorio
vLLM8000Orientado 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:

CampoDescripción
baseUrlDirecció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.
apiUsa el protocolo compatible con OpenAI; debe escribirse fijo como openai-completions
apiKeyValor 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[].idID del modelo utilizado al llamar; debe coincidir con el nombre del modelo descargado localmente
models[].nameNombre mostrado en el selector
models[].contextWindowTamaño de la ventana de contexto (tokens)
models[].maxTokensLongitud máxima de salida por solicitud (tokens)
models[].inputTipos de entrada compatibles
Otras extensiones