docs
Agentes en la terminal

Pi

Markdown

Agente en la terminal · OpenAI Chat, Anthropic Messages, Gemini

Guía completa
FormatoDónde configurar
OpenAI Chat, Anthropic Messages, Gemini~/.pi/agent/models.json (o .pi/models.json del proyecto, después de confiar en él); selección mediante /model

Configuración

Copia la configuración y reemplaza sk-... por tu clave del panel de Ailoot. Es mejor guardar la clave en la variable de entorno AILOOT_API_KEY si la aplicación lo permite.

Antes de iniciar, consulte GET /v1/models con su clave de Ailoot. Elija un ID exacto de modelo cuyos métodos incluyan POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent y úselo en la configuración. Para agentes, compruebe también las herramientas y funciones que requiere su versión del cliente.

{
  "providers": {
    "ailoot": {
      "baseUrl": "https://api.ailoot.ai/v1",
      "api": "openai-completions",
      "apiKey": "$AILOOT_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5-5",
          "input": [
            "text",
            "image"
          ]
        },
        {
          "id": "deepseek-v4-pro"
        }
      ]
    }
  }
}

Esta configuración lee la clave de la variable AILOOT_API_KEY. Defínela antes de iniciar la aplicación:

export AILOOT_API_KEY="sk-..."   # agrega a ~/.zshrc o ~/.bashrc

Modelo de ejemplo: claude-sonnet-5-5. Para cualquier otro modelo, consulta el catálogo y verifica que tenga el formato necesario.

Qué debes saber

Verificación

  • Para el formato OpenAI, la URL es https://api.ailoot.ai/v1 (o la ruta completa, si la aplicación pide la URL completa).
  • Para el formato Anthropic, la URL es https://api.ailoot.ai — la dirección raíz de la API. El ejemplo anterior no muestra la configuración completa de este formato; consulta la documentación del cliente para comprobar qué ruta debes introducir en su campo. El prefijo de la ruta de la API es — /v1.
  • Para el formato Gemini, la URL es https://api.ailoot.ai — la dirección raíz de la API. El ejemplo anterior no muestra la configuración completa de este formato; consulta la documentación del cliente para comprobar qué ruta debes introducir en su campo. El prefijo de la ruta de la API es — /v1beta.
  • Haz una pregunta corta. Si recibes un error, consulta el código y el Request ID y compáralos con la página Errores y límites.
  • Un 404 justo después de configurar casi siempre indica una URL incorrecta: sobra o falta /v1.
  • 402: no hay suficiente saldo para la reserva. Los agentes reservan más que un chat: por qué.

Documentación de la aplicación: https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.Contactar a soporte