docs
Agentes en el terminal

Factory Droid

Markdown

Agente en el terminal · OpenAI Chat, OpenAI Responses, Anthropic Messages

Guía completa
FormatoDónde configurar
OpenAI Chat, OpenAI Responses, Anthropic Messages~/.factory/settings.json → array customModels; selecciona el modelo con /model, en «Custom models»

Configuración

Copia la configuración y sustituye sk-... por tu clave del panel de control de Ailoot. Es mejor guardar la clave en la variable de entorno AILOOT_API_KEY si la aplicación lo permite.

Antes de iniciar, consulte GET /v1/models con su clave de Ailoot. Elija un ID exacto de modelo cuyos métodos incluyan POST /v1/chat/completions, POST /v1/responses, POST /v1/messages y úselo en la configuración. Para agentes, compruebe también las herramientas y funciones que requiere su versión del cliente.

{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Claude Sonnet 5.5 (Ailoot)",
      "baseUrl": "https://api.ailoot.ai",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    },
    {
      "model": "gpt-6.1-sol",
      "displayName": "GPT-6.1 Sol (Ailoot)",
      "baseUrl": "https://api.ailoot.ai/v1",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "openai",
      "maxOutputTokens": 64000
    },
    {
      "model": "deepseek-v4-pro",
      "displayName": "DeepSeek V4 Pro (Ailoot)",
      "baseUrl": "https://api.ailoot.ai/v1",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 32000
    }
  ]
}

Esta configuración lee la clave de la variable AILOOT_API_KEY. Defínela antes de iniciar la aplicación:

export AILOOT_API_KEY="sk-..."   # añade a ~/.zshrc o ~/.bashrc

Modelo de ejemplo: claude-sonnet-5-5. Para cualquier otro modelo, consulta el catálogo y comprueba que tenga el formato necesario.

Qué debes saber

Comprobación

  • Para el formato OpenAI, la URL es https://api.ailoot.ai/v1 (o la ruta completa, si la aplicación pide la URL completa).
  • Para el formato Anthropic, la URL es https://api.ailoot.ai sin /v1.
  • Haz una pregunta corta. Si recibes un error, consulta el código y el Request ID y compáralos con la página Errores y límites.
  • Un 404 justo después de configurar casi siempre indica una URL incorrecta: sobra o falta /v1.
  • 402: no hay suficiente saldo para la reserva. Los agentes reservan más que un chat: por qué.

Documentación de la aplicación: https://docs.factory.com/model-independence/byok

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.Contactar con soporte