Configuration des Coding Agents

Configurer Droid : clé API, Base URL et modèles

Installez Droid, configurez la Base URL et l’API Key BetterToken, choisissez un modèle disponible et résolvez les erreurs courantes. Plus.

Pour connecter Droid à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actuel du model plaza

Prérequis

La version actuelle de l’outil est installée
Une BetterToken API Key : inscrivez-vous pour en obtenir une
Un Model ID du model plaza

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Exigences supplémentaires

Installation

Installer Droid

macOS / Linux

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

Windows

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

Configuration manuelle

Vous pouvez ajouter un modèle dans la CLI via /settings → Custom models ou /model → Manage custom models. Dans l’application de bureau, ouvrez Settings → Custom Models. Les deux éditeurs enregistrent dans ~/.factory/settings.json ; la configuration par fichier ci-dessous constitue une autre méthode. Consultez le guide des modèles personnalisés de Factory.

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actuel du model plaza

Configuration

Définir la BetterToken API Key

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

Remplacez YOUR_API_KEY par votre BetterToken API Key. Droid prend en charge l’expansion de variable d’environnement ${BETTERTOKEN_API_KEY} dans sa configuration JSON.

Modifier le fichier de configuration Droid

Chemin du fichier de configuration : ~/.factory/settings.json

{
  "customModels": [
    {
      "displayName": "BetterToken Codex",
      "model": "YOUR_MODEL_ID",
      "baseUrl": "https://bettertoken.ai/v1",
      "apiKey": "${BETTERTOKEN_API_KEY}",
      "provider": "openai"
    }
  ]
}

Remplacez YOUR_MODEL_ID par un model ID actuel disponible copié depuis le model plaza.

Démarrer Droid et sélectionner le modèle

cd /path/to/your/project
droid

Saisissez /model dans Droid et sélectionnez BetterToken Codex. Factory surveille les modifications du fichier de configuration ; si la liste des modèles ne se met pas à jour, quittez et relancez Droid.

Exécuter une petite tâche de test

Commencez par une petite tâche, telle que « Explique la structure des répertoires de ce projet. » Lorsque Droid renvoie un résultat, passez à des modifications multi-fichiers ou à des tâches d’agent plus longues.

Lors des tests avec Droid 0.248.0, dans un nouveau profil sans connexion à Factory, droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK" a fonctionné avec les deux valeurs : openai a envoyé les requêtes vers /v1/responses et generic-chat-completion-api vers /v1/chat/completions. Utilisez droid exec pour une vérification non interactive.

Vérifier la connexion

Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ Model dans la configuration. Utilisez le Model ID exact du model plaza, puis redémarrez la session actuelle.

Erreurs courantes

Dépannage

Symptôme	Vérifications
Le modèle personnalisé n’apparaît pas dans `/model`	Validez le JSON et confirmez que `model`, `baseUrl`, `apiKey` et `provider` sont tous présents
`Invalid provider`	Utilisez la valeur exacte en minuscules `"openai"` ou `"generic-chat-completion-api"`, pas un libellé de l’interface
`401` ou `403`	Copiez à nouveau l’API Key, confirmez que le processus Droid peut lire `BETTERTOKEN_API_KEY`, puis vérifiez le solde du compte
`404` ou Model not found	Utilisez `https://bettertoken.ai/v1` et copiez un model ID GPT actuel depuis le model plaza
L’ancien modèle reste après modification	Ouvrez à nouveau `/model` ; s’il ne s’actualise toujours pas, quittez complètement Droid et relancez-le

FAQ

Configurer le modèle

Copiez le Model ID exact depuis la model plaza.

Définissez provider sur openai pour utiliser OpenAI Responses API avec la Base URL https://bettertoken.ai/v1, ou sur generic-chat-completion-api pour Chat Completions.

Ai-je besoin d’en-têtes personnalisés ?

Aucun en-tête supplémentaire n’est nécessaire pour une configuration BetterToken standard. Ajoutez des en-têtes de locataire, de routage ou d’audit uniquement lorsqu’une autre passerelle les exige explicitement.

Où consulter la tarification et l’utilisation ?

Utilisez le model plaza en direct pour connaître la tarification actuelle des modèles. L’utilisation des Request et le solde sont disponibles dans le Dashboard BetterToken.

FAQ associée

Configuration avancée

Guides associés

Présentation de Factory BYOK

Détails techniques

Protocole, endpoint et champs internes du fournisseur

Cette configuration utilise https://bettertoken.ai/v1. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas /chat/completions ni /responses sauf si un champ spécifique l’exige explicitement.