Factory Droid

Une entrée customModels dans ~/.factory/settings.json — model, baseUrl et provider — place Droid sur tout endpoint parlant Anthropic Messages ou OpenAI Chat Completions.

// ~/.factory/settings.json  (Windows: %USERPROFILE%\.factory\settings.json)
{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "Sonnet 5 [Kunavo]",
      "baseUrl": "https://api.kunavo.com",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "anthropic"
    },
    {
      "model": "gpt-5-6-sol",
      "displayName": "GPT-5.6 Sol [Kunavo]",
      "baseUrl": "https://api.kunavo.com/v1",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

// Then, in the shell Droid starts from:
//   export KUNAVO_API_KEY=sk-kn-...
// ${VAR_NAME} expansion is a settings.json feature. It does NOT apply to the
// legacy ~/.factory/config.json, which Factory still loads and merges.

Étape par étape

1. Créez une clé sur /app/keys et copiez-la : elle ne s’affiche qu’une seule fois. Exportez-la sous la forme KUNAVO_API_KEY dans le shell depuis lequel vous lancez Droid, afin que la clé elle-même ne soit jamais enregistrée dans un fichier de paramètres.
2. Ouvrez ~/.factory/settings.json (créez-le s’il n’existe pas) et ajoutez le tableau customModels ci-dessus. Factory marque exactement trois champs comme obligatoires — model, baseUrl et provider — et displayName est le libellé affiché par le sélecteur.
3. Vérifiez l’orthographe de provider. La valeur doit être exactement l’une de celles-ci : anthropic, openai ou generic-chat-completion-api ; la section de dépannage de Factory indique qu’une faute à cet endroit est à l’origine de son erreur "Invalid provider".
4. Exécutez /model dans la CLI. Vos entrées apparaissent dans une section distincte Modèles personnalisés, sous celles de Factory, avec le libellé displayName que vous avez défini. Factory surveille le fichier de paramètres : il suffit donc de l’enregistrer, sans redémarrage.
5. Donnez-lui une tâche qui lit et modifie un fichier plutôt qu’une simple salutation. Droid s’appuie sur les appels d’outils pour presque tout ce qu’il fait, et un simple échange de chat ne permet pas de tester cette partie. Exécutez ensuite /cost : c’est là que Factory affiche les taux de succès du cache. Kunavo prend en charge nativement les marqueurs cache_control d’Anthropic, et Factory précise que, chez le fournisseur générique Chat Completions, la mise en cache « varie selon le fournisseur et ne peut pas être garantie ».

Vérifié avec La page Modèles personnalisés (BYOK) de Factory le 21 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans Factory Droid.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Ce qu’un modèle personnalisé n’atteint pas dans Droid

Trois limites proviennent des pages de Factory, et chacune modifie ce que vous pouvez attendre de la configuration ci-dessus, sans remettre en cause son fonctionnement.

• Interfaces locales uniquement. La page BYOK de Factory indique que les modèles personnalisés sont disponibles dans la CLI Droid et l’application de bureau, qui lisent votre settings.json local, et qu’ils « n’apparaissent pas sur les plateformes web ou mobiles hébergées de Factory ». Tout travail délégué via le produit hébergé continue d’utiliser l’inférence facturée par Factory, quelle que soit la clé configurée ici.
• Un administrateur peut désactiver cette option. La documentation des contrôles d’entreprise de Factory décrit modelPolicy.allowCustomModels et allowedBaseUrls, qui désactivent entièrement le BYOK des utilisateurs ou imposent un hôte approuvé pour tous les modèles personnalisés. Sur une machine gérée, vérifiez ce point avant de chercher l’origine d’un problème dans le fichier.
• Les frais d’abonnement restent dus. Une clé ajoutée ici vient en complément, elle ne remplace rien : les frais facturés par Factory au-delà de l’allocation BYOK et le montant de cette allocation sont traités dans le guide des coûts et ne sont pas recalculés sur cette page.

Voici un piège à connaître avant de copier une configuration trouvée ailleurs : Factory charge toujours le fichier historique ~/.factory/config.json avec les clés snake_case custom_models et base_url, qu’il fusionne sous settings.json, et précise que l’expansion de ${VAR_NAME} ne s’y applique pas. Une clé enregistrée comme espace réservé dans ce fichier est envoyée telle quelle. Utilisez settings.json.