Connexion de Factory Droid CLI

Difficulté ⌨️ Avancé　|　Format d'interface Compatible OpenAI　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

Factory Droid CLI (droid) est un agent de programmation IA pour le terminal, créé par Factory AI. Il vous permet de lire du code, corriger des bugs, refactoriser et écrire de nouvelles fonctionnalités directement depuis la ligne de commande. Il prend en charge les points de terminaison de modèles personnalisés, ce qui vous permet de basculer le backend d'inférence vers Byesu API.

Avant de commencer

Rendez-vous d'abord sur Console → Jetons pour créer un jeton API (de la forme sk-xxxx), et choisissez le bon groupe pour ce jeton — le groupe détermine quels modèles vous pouvez appeler et par quelle ligne ils passent. Voir Choisir un groupe pour plus de détails.

Étape 1 : Installer Droid CLI

Windows

irm https://app.factory.ai/cli/windows | iex

macOS / Linux

curl -fsSL https://app.factory.ai/cli | sh

Une fois l'installation terminée, mettez à jour votre PATH en suivant les instructions, puis connectez-vous une fois avec un compte Factory officiel gratuit (uniquement pour l'authentification du client lui-même, cela n'affecte pas le fait que les modèles passent par byesu).

Remarque pour Windows

Si vous rencontrez une erreur de permission ou de stratégie d'exécution : exécutez PowerShell en tant qu'administrateur et lancez Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

Étape 2 : Configurer la connexion à byesu

Il existe deux méthodes ; nous recommandons le script en un clic.

Méthode 1 (la plus rapide) : script en un clic

Après l'avoir lancé, il vous suffit de renseigner la base_url et la API Key comme demandé ; le script écrira automatiquement le fichier de configuration :

Windows

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash

• base_url : saisissez https://byesu.com/v1
• API Key : saisissez le jeton sk-xxxx que vous avez créé dans la console byesu

Méthode 2 (manuelle) : modifier le fichier de configuration

Modifiez ~/.factory/config.json (sous Windows, %USERPROFILE%\.factory\config.json) et ajoutez les entrées de modèles byesu dans le tableau custom_models :

{
  "custom_models": [
    {
      "model_display_name": "GPT-5.5 [byesu]",
      "model": "gpt-5.5",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Claude Opus 4.8 [byesu]",
      "model": "claude-opus-4-8",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Gemini 3.1 Pro [byesu]",
      "model": "gemini-3.1-pro-high",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    }
  ]
}

Explication des champs :

• model : le vrai nom du modèle sur byesu (par exemple gpt-5.5, claude-opus-4-8, gemini-3.1-pro-high) ; assurez-vous bien que le groupe de votre jeton prend en charge ce modèle.
• base_url : toujours https://byesu.com/v1 (format compatible OpenAI, avec /v1).
• api_key : votre jeton sk-xxxx.
• provider : toujours openai.
• model_display_name : le nom affiché dans le menu de sélection du CLI, à votre convenance.

Utiliser le format natif Anthropic

Ci-dessus, nous utilisons le point de terminaison compatible OpenAI (le plus simple). Si vous souhaitez qu'une entrée passe par le protocole natif Anthropic, remplacez le provider de cette entrée par anthropic et changez la base_url en https://byesu.com sans /v1. En général, conservez openai + https://byesu.com/v1, c'est suffisant.

Étape 3 : Lancer et vérifier

Démarrez depuis le répertoire de votre projet :

cd /path/to/your/project
droid

Une fois dans l'interface interactive, utilisez /model (ou le menu de sélection des modèles au démarrage) pour basculer vers le modèle … [byesu] que vous venez de configurer, puis demandez-lui par exemple de lire un fichier ou d'expliquer un extrait de code. S'il répond normalement, la connexion est réussie.

Bloqué ?

• 401 / Unauthorized : l'api_key est erronée ou il manque le préfixe sk- ; vérifiez que le jeton n'est pas désactivé. Voir Erreurs courantes #auth.
• Aucun canal disponible / no channel : le groupe du jeton actuel ne prend pas en charge le model saisi ; choisissez un autre modèle dans ce groupe, ou choisissez un groupe à nouveau. Voir Erreurs courantes #no-channel.
• Solde insuffisant / 402 : le solde de votre compte est insuffisant, rechargez-le d'abord. Voir Erreurs courantes #balance.
• Échec de connexion / 404 : la base_url est incorrecte — le format compatible OpenAI doit être https://byesu.com/v1 (avec /v1).

Pour plus de dépannage, voir Erreurs courantes et Choisir un groupe.