Droid setup: installation, API key, Base URL, and custom models

To connect Droid to BetterToken, prepare an API key, enter the Base URL shown below, and choose a current Model ID from the model plaza.

Key settings

Field	Value
API Key	BetterToken API key
Base URL	`https://bettertoken.ai/v1`
Model	A current Model ID from the model plaza

Prerequisites

The current version of the tool is installed
A BetterToken API key: register and get one
A Model ID from the model plaza

Additional requirements

Install

Install Droid

macOS / Linux
Windows

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

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

Manual setup

Field	Value
API Key	BetterToken API key
Base URL	`https://bettertoken.ai/v1`
Model	A current Model ID from the model plaza

Setup

Set the BetterToken API Key

macOS / Linux
Windows PowerShell

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

Replace YOUR_API_KEY with your BetterToken API Key. Droid supports ${BETTERTOKEN_API_KEY} environment-variable expansion in its JSON configuration.

Edit the Droid config file

Config file path: ~/.factory/settings.json

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

Replace YOUR_MODEL_ID with a current model ID from a supported provider copied from the model plaza.

Start Droid and select the model

cd /path/to/your/project
droid

Enter /model in Droid and select BetterToken Codex. Factory watches the settings file for changes; if the model list does not refresh, exit and relaunch Droid.

Run a small test task

Start with a small task such as “Explain this project’s directory structure.” Once Droid returns a result, continue with cross-file edits or longer agent tasks.

Set provider to openai. In Factory’s BYOK configuration, this value selects the OpenAI Responses API. Use https://bettertoken.ai/v1 and an BetterToken API Key.

Verify the connection

Send a short test prompt. If the tool returns a response without an authentication or Model ID error, the connection works. Fully restart the tool after changing its configuration.

Switch models

Open the model selector or change the Model field in the configuration. Use the exact Model ID from the model plaza, then restart the current session.

Common errors

Troubleshooting

Symptom	What to check
The custom model is missing from `/model`	Validate the JSON and confirm that `model`, `baseUrl`, `apiKey`, and `provider` are all present
`Invalid provider`	Use the exact lowercase value `"openai"`, not a UI display label
`401` or `403`	Copy the API Key again, confirm the Droid process can read `BETTERTOKEN_API_KEY`, and check your account balance
`404` or Model not found	Use `https://bettertoken.ai/v1` and copy a current GPT model ID from the model plaza
The old model remains after editing	Open `/model` again; if it still does not refresh, fully exit and relaunch Droid

FAQ

Why should I use the supported provider?

Droid’s provider: "openai" uses the OpenAI Responses API. BetterToken’s supported provider provides the matching OpenAI-compatible endpoint and model IDs.

Do I need custom headers?

No extra headers are required for a standard BetterToken setup. Add tenant, routing, or audit headers only when another gateway explicitly requires them.

Where can I check pricing and usage?

Use the live model plaza for current model pricing. Request usage and balance are available in the BetterToken Dashboard.

Advanced setup

Supported providers

Provider	Status
Claude	Not supported
GPT	Manual setup
Kimi	Manual setup
GLM	Manual setup

Statuses apply to the BetterToken setup documented on this page.

What the setup methods mean

Manual setup: enter the API Key, Base URL, and Model.
Not supported: no verified direct setup is currently available.

Factory BYOK overview

Technical details

Protocol, endpoint, and internal provider fields

This setup uses https://bettertoken.ai/v1. The tool appends the OpenAI-compatible endpoint path. Do not add /chat/completions or /responses unless a specific field explicitly requires it.

Getting started

Coding Agent setup

AI application platform setup

Advanced

Droid setup: installation, API key, Base URL, and custom models

Key settings

Prerequisites

Additional requirements

Install

Install Droid

Manual setup

Setup

Verify the connection

Switch models

Common errors

Troubleshooting

FAQ

Why should I use the supported provider?

Do I need custom headers?

Where can I check pricing and usage?

Advanced setup

Supported providers

Technical details

​Key settings

​Prerequisites

​Additional requirements

​Install

​Install Droid

​Manual setup

​Setup

​Verify the connection

​Switch models

​Common errors

​Troubleshooting

​FAQ

​Why should I use the supported provider?

​Do I need custom headers?

​Where can I check pricing and usage?

​Related FAQ

​Advanced setup

​Supported providers

​Related guides

​Technical details

Key settings

Prerequisites

Additional requirements

Install

Install Droid

Manual setup

Setup

Verify the connection

Switch models

Common errors

Troubleshooting

FAQ

Why should I use the supported provider?

Do I need custom headers?

Where can I check pricing and usage?

Related FAQ

Advanced setup

Supported providers

Related guides

Technical details