docs
Agents dans le terminal

Pi

Markdown

Agent dans le terminal · OpenAI Chat, Anthropic Messages, Gemini

Guide complet
FormatOù configurer
OpenAI Chat, Anthropic Messages, Gemini~/.pi/agent/models.json, ou .pi/models.json du projet après lui avoir accordé votre confiance ; choix : /model

Configuration

Copiez la configuration et remplacez sk-... par votre clé de l’espace personnel Ailoot. Il est préférable de stocker la clé dans la variable d’environnement AILOOT_API_KEYsi l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

{
  "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"
        }
      ]
    }
  }
}

Cette configuration lit la clé dans la variable AILOOT_API_KEY. Définissez-la avant de lancer l’application :

export AILOOT_API_KEY="sk-..."   # Ajoutez à ~/.zshrc ou ~/.bashrc

Exemple de modèle : claude-sonnet-5-5. Choisissez tout autre modèle dans catalogue — vérifiez qu’il prend en charge le format requis.

À savoir

Vérification

  • Pour le format OpenAI, l’adresse est https://api.ailoot.ai/v1 (ou le chemin complet si l’application demande une adresse complète).
  • Pour le format Anthropic, l’adresse est https://api.ailoot.ai — l’adresse racine de l’API. La configuration complète de ce format n’est pas présentée dans l’exemple ci-dessus ; consultez la documentation du client pour vérifier le chemin à saisir dans son champ. Le préfixe de la route API est — /v1.
  • Pour le format Gemini, l’adresse est https://api.ailoot.ai — l’adresse racine de l’API. La configuration complète de ce format n’est pas présentée dans l’exemple ci-dessus ; consultez la documentation du client pour vérifier le chemin à saisir dans son champ. Le préfixe de la route API est — /v1beta.
  • Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page Erreurs et limites.
  • Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de /v1.
  • Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : explication.

Documentation de l’application : https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à comprendre.Contacter l’assistance