Configurar Droid: API Key, Base URL y modelos

Para conectar Droid con BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un ID de modelo vigente en la model plaza.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Un ID de modelo vigente de la model plaza

Requisitos previos

• La versión actual de la herramienta está instalada
• Una BetterToken API Key: regístrate y obtén una
• Un ID de modelo de la model plaza

Regístrate y obtén una BetterToken API Key→

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Requisitos adicionales

Instalación

Instala Droid

macOS / Linux

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

Windows

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

Configuración manual

Puedes añadir un modelo en la CLI desde /settings → Custom models o /model → Manage custom models. En la aplicación de escritorio, abre Settings → Custom Models. Ambos editores guardan los cambios en ~/.factory/settings.json; la configuración por archivo que aparece a continuación es una alternativa. Consulta la guía de modelos personalizados de Factory.

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Un ID de modelo vigente de la model plaza

Pasos de configuración

Define la BetterToken API Key

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

Sustituye YOUR_API_KEY por tu BetterToken API Key. Droid admite la expansión de la variable de entorno ${BETTERTOKEN_API_KEY} en su configuración JSON.

Edita el archivo de configuración de Droid

Ruta del archivo de configuración: ~/.factory/settings.json

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

Sustituye YOUR_MODEL_ID por un ID de modelo disponible vigente, copiado desde la model plaza.

Inicia Droid y selecciona el modelo

cd /path/to/your/project
droid

Introduce /model en Droid y selecciona BetterToken Codex. Factory supervisa los cambios del archivo de ajustes; si la lista de modelos no se actualiza, cierra Droid y vuelve a iniciarlo.

Ejecuta una tarea de prueba pequeña

Empieza con una tarea pequeña, como «Explica la estructura de directorios de este proyecto». Cuando Droid devuelva un resultado, continúa con cambios entre archivos o tareas más largas con agentes.

Establece provider en openai. En la configuración BYOK de Factory, este valor selecciona la API Responses de OpenAI. Usa https://bettertoken.ai/v1 y una BetterToken API Key. Para usar Chat Completions, establece provider en generic-chat-completion-api; la Base URL no cambia.

En las pruebas con Droid 0.248.0, en un perfil nuevo sin iniciar sesión en Factory, droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK" funcionó con ambos valores: openai envió solicitudes a /v1/responses y generic-chat-completion-api a /v1/chat/completions. Usa droid exec para una comprobación no interactiva.

Verifica la conexión

Envía un prompt de prueba breve. Si la herramienta responde sin errores de autenticación ni de ID del modelo, la conexión funciona. Reinicia por completo la herramienta después de cambiar la configuración.

Cambia de modelo

Abre el selector de modelos o cambia el campo Model de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.

Errores habituales

Solución de problemas

Síntoma	Qué comprobar
El modelo personalizado no aparece en /model	Valida el JSON y confirma que incluya model, baseUrl, apiKey y provider
Invalid provider	Usa el valor exacto en minúsculas "openai" o "generic-chat-completion-api", no una etiqueta de la interfaz
401 o 403	Vuelve a copiar la API Key, confirma que el proceso de Droid pueda leer BETTERTOKEN_API_KEY y comprueba el saldo de tu cuenta
404 o modelo no encontrado	Usa https://bettertoken.ai/v1 y copia un ID de modelo GPT vigente desde la model plaza
El modelo antiguo permanece después de editar	Abre /model de nuevo; si no se actualiza, cierra Droid por completo y vuelve a iniciarlo

Preguntas frecuentes

Configura el modelo

Copia el Model ID exacto de la model plaza.

Configura provider como openai para usar OpenAI Responses API con la Base URL https://bettertoken.ai/v1, o como generic-chat-completion-api para Chat Completions.

¿Necesito cabeceras personalizadas?

Una configuración estándar de BetterToken no requiere cabeceras adicionales. Añade cabeceras de tenant, enrutamiento o auditoría solo cuando otro gateway las exija explícitamente.

¿Dónde puedo consultar los precios y el uso?

Consulta los precios actuales de los modelos en la model plaza. El uso de las solicitudes y el saldo están disponibles en el Dashboard de BetterToken.

Preguntas relacionadas

• API compatible con OpenAI frente a API compatible con Anthropic

• MCP frente a API Key y Base URL

• ¿Qué son model_provider, base_url y wire_api?

• Cómo configurar una API compatible con OpenAI en Cline

• Compara todas las herramientas compatibles

• Errores de API, códigos de estado y límites de solicitudes

Configuración avanzada

Guías relacionadas

• Descripción general de Factory BYOK

Detalles técnicos

Protocolo, endpoint y campos internos del proveedor

Esta configuración usa https://bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija explícitamente.