Configuração de Coding Agents

Configurar Droid: API Key, Base URL e modelos

Instale o Droid, configure a Base URL e a API Key da BetterToken, escolha um modelo compatível e corrija erros comuns. Com configuração, exemplos e soluções.

Para conectar o Droid à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	Um ID atual da model plaza

Pré-requisitos

A versão atual da ferramenta está instalada
Uma BetterToken API Key: cadastre-se e crie uma
Um ID de modelo da model plaza

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Requisitos adicionais

Instalação

Instalar o Droid

macOS / Linux

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

Windows

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

Configuração manual

Você pode adicionar um modelo na CLI em /settings → Custom models ou /model → Manage custom models. No aplicativo Desktop, abra Settings → Custom Models. Os dois editores salvam em ~/.factory/settings.json; a configuração por arquivo abaixo é uma alternativa. Consulte o guia de modelos personalizados da Factory.

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	Um ID atual da model plaza

Configuração

Defina a BetterToken API Key

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

Substitua YOUR_API_KEY pela sua BetterToken API Key. O Droid aceita a expansão da variável ${BETTERTOKEN_API_KEY} na configuração JSON.

Edite o arquivo de configuração do Droid

Caminho do arquivo: ~/.factory/settings.json

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

Substitua YOUR_MODEL_ID por um ID de modelo disponível atual copiado da model plaza.

Inicie o Droid e selecione o modelo

cd /path/to/your/project
droid

Informe /model no Droid e selecione BetterToken Codex. O Factory observa mudanças no arquivo de configurações; se a lista não for atualizada, encerre e abra novamente o Droid.

Execute uma pequena tarefa de teste

Comece com uma tarefa pequena, como “Explique a estrutura de diretórios deste projeto.” Depois que o Droid retornar um resultado, prossiga com alterações entre arquivos ou tarefas mais longas com agente.

Nos testes com Droid 0.248.0, em um perfil novo sem fazer login no Factory, droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK" funcionou com os dois valores: openai enviou solicitações para /v1/responses e generic-chat-completion-api para /v1/chat/completions. Use droid exec para uma verificação não interativa.

Teste a conexão

Envie um prompt curto. Se a ferramenta responder sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta após alterar a configuração.

Alterne entre modelos

Abra o seletor ou altere o campo Model na configuração. Use o ID exato da model plaza e reinicie a sessão atual.

Erros comuns

Solução de problemas

Sintoma	O que verificar
O modelo personalizado não aparece em `/model`	Valide o JSON e confirme que `model`, `baseUrl`, `apiKey` e `provider` estão presentes
`Invalid provider`	Use o valor exato em minúsculas `"openai"` ou `"generic-chat-completion-api"`, não o nome exibido na interface
`401` ou `403`	Copie a API Key novamente, confirme que o processo Droid lê `BETTERTOKEN_API_KEY` e confira o saldo da conta
`404` ou modelo não encontrado	Use `https://bettertoken.ai/v1` e copie um ID GPT atual da model plaza
O modelo antigo continua após editar	Abra `/model` novamente; se a lista não atualizar, encerre e abra o Droid de novo

FAQ

Configure o modelo

Copie o Model ID exato da model plaza.

Defina provider como openai para usar OpenAI Responses API com a Base URL https://bettertoken.ai/v1, ou como generic-chat-completion-api para Chat Completions.

Preciso de cabeçalhos personalizados?

Nenhum cabeçalho extra é exigido em uma configuração padrão da BetterToken. Adicione cabeçalhos de tenant, roteamento ou auditoria apenas quando outro gateway os exigir explicitamente.

Onde posso conferir preços e uso?

Use a model plaza para ver os preços atuais. O uso das solicitações e o saldo estão disponíveis no Dashboard da BetterToken.

FAQ relacionados

Configuração avançada

Guias relacionados

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa https://bettertoken.ai/v1. A ferramenta adiciona o caminho do endpoint compatível com OpenAI. Não acrescente /chat/completions nem /responses, a menos que um campo específico exija.