Factory Droid

Una entrada customModels en ~/.factory/settings.json — model, baseUrl y provider — coloca Droid sobre cualquier endpoint compatible con Anthropic Messages u 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.

Paso a paso

1. Crea una clave en /app/keys y cópiala: solo se muestra una vez. Expórtala como KUNAVO_API_KEY en la shell desde la que inicies Droid, para que la clave no se guarde nunca en un archivo de configuración.
2. Abre ~/.factory/settings.json (créalo si no existe) y añade el array customModels de arriba. Factory marca exactamente tres campos como obligatorios: model, baseUrl y provider; displayName es la etiqueta que muestra el selector.
3. Comprueba que provider esté escrito correctamente. Debe ser exactamente uno de estos valores: anthropic, openai o generic-chat-completion-api; la sección de solución de problemas de Factory indica que un error tipográfico en ese campo provoca el error "Invalid provider".
4. Ejecuta /model en la CLI. Tus entradas aparecerán en una sección independiente llamada Modelos personalizados, debajo de los modelos propios de Factory y con la etiqueta displayName que configuraste. Factory supervisa el archivo de configuración, así que basta con guardarlo; no hace falta reiniciar.
5. Asígnale una tarea que lea y modifique un archivo, en lugar de limitarte a saludar. Droid recurre a las llamadas a herramientas para casi todo lo que hace, y un turno de chat simple no pondrá eso a prueba. Después ejecuta /cost, donde Factory muestra las tasas de aciertos de caché. Kunavo ofrece de forma nativa los marcadores cache_control de Anthropic, y la propia nota de Factory indica que, con el proveedor genérico Chat Completions, el almacenamiento en caché «varía según el proveedor y no se puede garantizar».

Comprobado con Página de modelos personalizados (BYOK) de Factory el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en 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"}]}'

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

A qué no da acceso un modelo personalizado en Droid

Hay tres limitaciones que se describen en las propias páginas de Factory. Cada una modifica lo que debes esperar de la configuración anterior, no si esta funciona.

• Solo está disponible en entornos locales. La página BYOK de Factory indica que los modelos personalizados están disponibles en la CLI de Droid y en la aplicación de escritorio, que leen tu archivo local settings.json, y que «no aparecen en las plataformas web alojadas ni móviles de Factory». Las tareas delegadas desde el producto alojado siguen ejecutándose con inferencia facturada por Factory, independientemente de la clave que hayas configurado aquí.
• Un administrador puede desactivarlo. Los controles empresariales de Factory documentan modelPolicy.allowCustomModels y allowedBaseUrls, que desactivan por completo el uso de BYOK por parte de los usuarios o restringen todos los modelos personalizados a un único host aprobado. Si usas un equipo administrado, compruébalo antes de investigar el archivo.
• La cuota del plan se sigue aplicando. Esta clave se añade al plan; no lo sustituye. La guía de costos explica qué cobra Factory por encima de su límite de BYOK y cuál es ese límite; esta página no vuelve a calcular esos importes.

Hay un detalle que conviene conocer antes de copiar una configuración de otro sitio: Factory sigue cargando el archivo heredado ~/.factory/config.json con custom_models y base_url en snake_case, y lo combina con settings.json. Además, documenta que la expansión de ${VAR_NAME} no se aplica en ese archivo. Si escribes una clave como marcador de posición allí, se envía literalmente. Usa settings.json.