Factory Droid

Ein customModels-Eintrag in ~/.factory/settings.json — model, baseUrl und provider — bringt Droid zu jedem Endpunkt, der Anthropic Messages oder OpenAI Chat Completions unterstützt.

// ~/.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.

Schritt für Schritt

1. Erstelle unter /app/keys einen Schlüssel und kopiere ihn – er wird nur einmal angezeigt. Setze ihn in der Shell, aus der du Droid startest, als KUNAVO_API_KEY, damit der Schlüssel selbst nicht in einer Einstellungsdatei landet.
2. Öffne ~/.factory/settings.json (erstelle die Datei, falls sie nicht vorhanden ist) und füge das Array customModels von oben hinzu. Factory kennzeichnet genau drei Felder als erforderlich: model, baseUrl und provider. displayName ist die Bezeichnung, die im Auswahlmenü angezeigt wird.
3. Überprüfe die Schreibweise von provider. Sie muss exakt einem dieser Werte entsprechen: anthropic, openai oder generic-chat-completion-api. Im Fehlerbehebungsabschnitt von Factory wird ein Tippfehler an dieser Stelle als Ursache für den Fehler "Invalid provider" aufgeführt.
4. Führe in der CLI /model aus. Deine Einträge erscheinen unterhalb der Factory-eigenen Modelle in einem separaten Abschnitt Benutzerdefinierte Modelle, gekennzeichnet mit dem von dir festgelegten displayName. Factory überwacht die Einstellungsdatei, daher genügt es, sie zu speichern – ein Neustart ist nicht erforderlich.
5. Gib dem Modell eine Aufgabe, bei der es eine Datei liest und bearbeitet, statt es nur zu begrüßen. Droid setzt bei fast allem, was es tut, auf Tool-Aufrufe; mit einem einfachen Chat-Durchlauf lässt sich genau dieser Teil nicht überprüfen. Führe anschließend /cost aus. Dort gibt Factory die Cache-Trefferraten an. Kunavo stellt die cache_control-Marker von Anthropic nativ bereit. Factory weist selbst darauf hin, dass das Caching beim generischen Chat-Completions-Provider „je nach Provider unterschiedlich ist und nicht garantiert werden kann“.

Abgeglichen mit Die Seite „Benutzerdefinierte Modelle (BYOK)“ von Factory am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in 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"}]}'

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Was ein benutzerdefiniertes Modell in Droid nicht erreicht

Drei Einschränkungen gehen aus den eigenen Seiten von Factory hervor. Jede davon verändert, was du von der obigen Konfiguration erwarten solltest, nicht aber, ob sie funktioniert.

• Nur lokal verfügbare Oberflächen. Auf der BYOK-Seite erklärt Factory, dass benutzerdefinierte Modelle in der Droid-CLI und der Desktop-App verfügbar sind, die deine lokale settings.json lesen, und dass sie „nicht auf den gehosteten Web- oder Mobilplattformen von Factory erscheinen“. Delegierte Arbeit, die über das gehostete Produkt läuft, verwendet weiterhin Inferenz, die Factory in Rechnung stellt – unabhängig davon, welchen Schlüssel du hier konfiguriert hast.
• Ein Administrator kann die Funktion deaktivieren. In der Dokumentation zu den Enterprise-Steuerungen führt Factory modelPolicy.allowCustomModels und allowedBaseUrls auf. Damit lässt sich BYOK für Benutzer vollständig deaktivieren oder jedes benutzerdefinierte Modell auf einen einzigen genehmigten Host festlegen. Prüfe das auf einem verwalteten Rechner, bevor du die Datei untersuchst.
• Die Gebühr für den Tarif bleibt bestehen. Ein Schlüssel hier kommt zusätzlich hinzu und ersetzt den Tarif nicht. Was Factory über das BYOK-Kontingent hinaus berechnet und wie hoch dieses Kontingent ist, wird im Kostenleitfaden behandelt und auf dieser Seite nicht erneut hergeleitet.

Eine Falle, die du kennen solltest, bevor du eine Konfiguration von anderer Stelle kopierst: Factory lädt weiterhin die alte ~/.factory/config.json mit den snake_case-Feldern custom_models und base_url und führt sie mit settings.json zusammen. Laut Dokumentation gilt die Expansion von ${VAR_NAME} dort nicht. Ein als Platzhalter in diese Datei geschriebener Schlüssel wird wörtlich übermittelt. Verwende settings.json.