Configuração do Droid: instalação, API Key, Base URL e modelos personalizados

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://www.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

Requisitos adicionais

Instalação

Instalar o Droid

macOS / Linux
Windows

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

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

Configuração manual

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

Configuração

Defina a BetterToken API Key

macOS / Linux
Windows PowerShell

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

$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://www.bettertoken.ai/v1",
      "apiKey": "${BETTERTOKEN_API_KEY}",
      "provider": "openai"
    }
  ]
}

Substitua YOUR_MODEL_ID por um ID de modelo de um provedor compatí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.

Defina provider como openai. Na configuração BYOK do Factory, esse valor seleciona a OpenAI Responses API. Use https://www.bettertoken.ai/v1 e uma BetterToken API Key.

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 exatamente o valor em minúsculas `"openai"`, não um rótulo da 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://www.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

Por que devo usar o provedor compatível?

O provider: "openai" do Droid usa a OpenAI Responses API. O provedor compatível da BetterToken oferece o endpoint e os IDs de modelo correspondentes.

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

Provedores compatíveis

Provedor	Status
Claude	Sem suporte
GPT	Configuração manual
Kimi	Configuração manual
GLM	Configuração manual

Os status se aplicam ao método de configuração do BetterToken descrito nesta página.

O que significa cada método de configuração

Configuração manual: informe a API Key, a Base URL e o Model.
Sem suporte: ainda não há um método verificado de conexão direta.

Guias relacionados

Visão geral do Factory BYOK

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa https://www.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.

Primeiros passos

Configuração de Coding Agents

Configuração de plataformas de aplicações de IA

Configuração avançada

Configuração do Droid: instalação, API Key, Base URL e modelos personalizados

Configurações principais

Pré-requisitos

Requisitos adicionais

Instalação

Instalar o Droid

Configuração manual

Configuração

Teste a conexão

Alterne entre modelos

Erros comuns

Solução de problemas

FAQ

Por que devo usar o provedor compatível?

Preciso de cabeçalhos personalizados?

Onde posso conferir preços e uso?

FAQ relacionados

Configuração avançada

Provedores compatíveis

Guias relacionados

Detalhes técnicos

​Configurações principais

​Pré-requisitos

​Requisitos adicionais

​Instalação

​Instalar o Droid

​Configuração manual

​Configuração

​Teste a conexão

​Alterne entre modelos

​Erros comuns

​Solução de problemas

​FAQ

​Por que devo usar o provedor compatível?

​Preciso de cabeçalhos personalizados?

​Onde posso conferir preços e uso?

​FAQ relacionados

​Configuração avançada

​Provedores compatíveis

​Guias relacionados

​Detalhes técnicos

Configurações principais

Pré-requisitos

Requisitos adicionais

Instalação

Instalar o Droid

Configuração manual

Configuração

Teste a conexão

Alterne entre modelos

Erros comuns

Solução de problemas

FAQ

Por que devo usar o provedor compatível?

Preciso de cabeçalhos personalizados?

Onde posso conferir preços e uso?

FAQ relacionados

Configuração avançada

Provedores compatíveis

Guias relacionados

Detalhes técnicos