Droid 설치 및 API 설정

Droid를 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 후 모델 광장에서 현재 Model ID를 선택하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
모델	모델 광장의 현재 Model ID

사전 요구 사항

• 최신 버전의 도구가 설치되어 있음
• BetterToken API Key: 등록하고 발급받기
• 모델 광장의 Model ID

가입하고 BetterToken API Key 받기→

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

추가 요구 사항

설치

Droid 설치

macOS / Linux

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

Windows

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

수동 설정

CLI에서는 /settings → Custom models 또는 /model → Manage custom models에서 모델을 추가할 수 있습니다. 데스크톱 앱에서는 Settings → Custom Models를 여세요. 두 편집기 모두 ~/.factory/settings.json에 저장합니다. 아래 파일 설정은 다른 방법입니다. Factory 사용자 지정 모델 가이드를 참고하세요.

필드	값
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
모델	모델 광장의 현재 Model ID

설정

BetterToken API Key 설정

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

YOUR_API_KEY를 BetterToken API Key로 바꾸세요. Droid는 JSON configuration에서 ${BETTERTOKEN_API_KEY} environment-variable expansion을 지원합니다.

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"
    }
  ]
}

YOUR_MODEL_ID를 모델 광장에서 복사한 현재 model ID로 바꾸세요.

Droid 시작 및 model 선택

cd /path/to/your/project
droid

Droid에서 /model을 입력하고 BetterToken Codex를 선택하세요. Factory는 settings file 변경을 감시합니다. model list가 refresh되지 않으면 Droid를 종료하고 다시 실행하세요.

작은 테스트 task 실행

“이 project의 directory structure를 설명해 주세요.” 같은 작은 task로 시작하세요. Droid가 result를 반환하면 cross-file edits 또는 더 긴 agent tasks를 진행하세요.

provider를 openai로 설정하세요. Factory의 BYOK 설정에서 이 값은 OpenAI Responses API를 선택합니다. https://bettertoken.ai/v1과 BetterToken API Key를 사용하세요. Chat Completions를 사용하려면 provider를 generic-chat-completion-api로 설정하세요. Base URL은 동일합니다.

Droid 0.248.0 테스트에서는 Factory에 로그인하지 않은 새 프로필에서 droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK"가 두 값 모두에서 성공했습니다. openai는 /v1/responses로, generic-chat-completion-api는 /v1/chat/completions로 요청을 보냈습니다. 비대화형으로 확인하려면 droid exec를 사용하세요.

연결 확인

짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.

모델 전환

model selector를 열거나 configuration의 Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.

일반적인 오류

문제 해결

증상	확인할 사항
사용자 지정 model이 /model에 없음	JSON을 validate하고 model, baseUrl, apiKey 및 provider가 모두 있는지 확인
Invalid provider	UI 표시 이름 대신 정확한 소문자 값 "openai" 또는 "generic-chat-completion-api"를 사용하세요
401 또는 403	API Key를 다시 복사하고 Droid process가 BETTERTOKEN_API_KEY를 읽을 수 있는지 확인한 뒤 account balance 확인
404 또는 Model not found	https://bettertoken.ai/v1을 사용하고 모델 광장에서 현재 GPT model ID 복사
편집 후에도 이전 model이 남음	/model을 다시 열고 그래도 refresh되지 않으면 Droid를 완전히 종료 후 다시 실행

FAQ

모델 설정

모델 광장에서 정확한 Model ID를 복사하세요.

provider를 openai로 설정하면 Base URL https://bettertoken.ai/v1로 OpenAI Responses API를 사용할 수 있습니다. Chat Completions를 사용하려면 generic-chat-completion-api로 설정하세요.

custom headers가 필요한가요?

표준 BetterToken setup에는 extra headers가 필요하지 않습니다. 다른 gateway가 명시적으로 요구할 때만 tenant, routing 또는 audit headers를 추가하세요.

pricing과 usage는 어디에서 확인할 수 있나요?

현재 model pricing은 live 모델 광장에서 확인하세요. request usage와 balance는 BetterToken Dashboard에서 볼 수 있습니다.

관련 FAQ

• OpenAI-compatible API와 Anthropic-compatible API 비교

• MCP와 API Key 및 Base URL 비교

• model_provider, base_url 및 wire_api란 무엇인가요?

• Cline에서 OpenAI-compatible API 구성

• 지원 도구 전체 비교

• API 오류, 상태 코드 및 요청 제한

Advanced setup

관련 가이드

• Factory BYOK 개요

기술 세부 정보

Protocol, endpoint 및 내부 provider 필드

이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.