docs
Agents dans le terminal

Factory Droid

Markdown

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

Guide complet
FormatOù configurer
OpenAI Chat, OpenAI Responses, Anthropic Messages~/.factory/settings.json → tableau customModels ; choix du modèle : commande /model, rubrique « Custom models »

Configuration

Copiez la configuration et remplacez sk-... par votre clé de l’espace client Ailoot. Il est préférable de stocker la clé dans la variable d’environnement AILOOT_API_KEY, si 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/responses, POST /v1/messages, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Claude Sonnet 5.5 (Ailoot)",
      "baseUrl": "https://api.ailoot.ai",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    },
    {
      "model": "gpt-6.1-sol",
      "displayName": "GPT-6.1 Sol (Ailoot)",
      "baseUrl": "https://api.ailoot.ai/v1",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "openai",
      "maxOutputTokens": 64000
    },
    {
      "model": "deepseek-v4-pro",
      "displayName": "DeepSeek V4 Pro (Ailoot)",
      "baseUrl": "https://api.ailoot.ai/v1",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 32000
    }
  ]
}

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 le 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 sans /v1.
  • 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 : pourquoi.

Documentation de l’application : https://docs.factory.com/model-independence/byok

Des questions ? Envoyez-nous le Request ID et une description : nous vous aiderons à y voir plus clair.Contacter l’assistance