시작하기

BetterToken 문서

BetterToken API Key로 Claude와 GPT를 코딩 도구나 직접 작성한 코드에 연결하세요. 프로토콜에 맞는 Base URL, SDK 예제, 요청 확인과 오류 해결 방법을 안내합니다.

BetterToken은 전 세계 개발자와 팀을 위한 AI 모델 API 게이트웨이입니다. Anthropic 및 OpenAI 호환 API를 통해 코딩 도구와 직접 작성한 코드를 사용 가능한 모델에 연결합니다. BetterToken API Key, 클라이언트 프로토콜에 맞는 Base URL, 모델 광장의 Model ID로 시작하세요.

시작하기

빠른 시작

계정을 만들고 잔액을 충전한 뒤 BetterToken API Key를 발급받으세요.

지원 도구

사용하는 CLI, 편집기, 데스크톱 앱, 자동화 플랫폼의 설정 가이드를 찾으세요.

용도에 맞는 연결 방식 선택하기

API Key를 만든 뒤 아래에서 작업에 맞는 행을 선택하세요. 요청을 보내기 전에 정확한 Model ID를 복사하세요.

작업	프로토콜	Base URL	시작 페이지
터미널에서 Claude Code 사용	Anthropic Messages	`https://bettertoken.ai`	Claude Code 설정
Codex CLI 또는 Codex App으로 로컬 작업 수행	OpenAI 호환, Responses	`https://bettertoken.ai/v1`	Codex CLI / App 설정
Cursor 또는 다른 외부 도구 연결	연결된 가이드에서 안내하는 OpenAI 호환 프로토콜	`https://bettertoken.ai/v1`	Cursor 설정 또는 전체 도구
직접 작성한 코드에서 모델 호출	OpenAI 호환 또는 Anthropic Messages	OpenAI: `https://bettertoken.ai/v1`, Anthropic: `https://bettertoken.ai`	Python, JavaScript, curl 예제
OpenAI Images로 이미지 생성 또는 편집	OpenAI 호환, Images	`https://bettertoken.ai/v1`	GPT Image 가이드 또는 Nano Banana 가이드

외부 도구에서는 도구 개요에 안내된 URL 입력란을 사용하세요. 일부 입력란에는 전체 요청 URL이 필요합니다.

자주 찾는 가이드

가이드	할 수 있는 작업
Claude Code	클라이언트 설치, 인증 및 모델 매핑 설정, 세션 확인
Codex CLI / App	로컬 API Key 연결을 위한 `config.toml`과 `auth.json` 설정
GPT Image	이미지 생성, 편집용 참조 이미지 업로드, 결과 저장
Nano Banana	이미지 워크플로 선택과 반환된 크기 확인
모델 업데이트	모델 소개를 읽고 모델 광장에서 현재 제공 여부 확인
자주 묻는 질문	계정, 프로토콜, 모델, 도구 설정 문제 해결

BetterToken 작동 방식

클라이언트가 BetterToken으로 모델 요청을 보냅니다. BetterToken은 여러 공급원에 연결하고 업스트림 서비스 간 동적 라우팅을 수행합니다. API Key, 잔액, 요청 기록은 하나의 Dashboard에서 관리하세요.

API 유형	Base URL	인증	텍스트 엔드포인트
OpenAI 호환	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Chat Completions, Responses
Anthropic Messages	`https://bettertoken.ai`	직접 API 호출 시 `x-api-key: YOUR_API_KEY`	Messages, 클라이언트가 `/v1/messages` 추가

하나의 BetterToken API Key로 사용 가능한 모든 모델을 호출할 수 있습니다. 클라이언트에 맞는 프로토콜을 선택하세요. Claude Code는 Anthropic Messages로 GPT와 다른 사용 가능한 모델을 호출할 수 있습니다. Claude Desktop은 클라이언트 제한 때문에 Claude 모델만 지원합니다. Gateway 가이드를 따라 설정하세요.

스트리밍과 도구 호출 지원은 모델마다 다릅니다. 기능을 구현하기 전에 사용할 Model ID로 작은 요청을 테스트하고 스트리밍과 도구 호출 가이드를 참고하세요. 이미지는 연결된 이미지 가이드를 따르세요. BetterToken은 검색을 결합한 이미지 생성을 지원하지 않습니다.

사용량 확인과 비용 관리

BetterToken Dashboard에서 요청별 모델, 상태, 토큰 사용량, 요금을 확인하세요. 프로젝트별로 여러 API Key를 만들고 Advanced settings에서 만료일이나 지출 한도를 설정할 수 있습니다. 방법은 빠른 시작을 참고하세요.

잔액이 소진되면 요청이 거부됩니다. 캐시 규칙은 캐시 과금 FAQ를, 제한 메시지 진단은 사용량 제한 FAQ를 참고하세요.

결제

러시아 외 지역 사용자는 Stripe 또는 USDT로 결제할 수 있습니다.

자주 묻는 질문

어떤 Base URL을 입력해야 하나요?

Anthropic SDK와 Claude Code는 https://bettertoken.ai, OpenAI SDK와 Codex CLI는 https://bettertoken.ai/v1을 사용하세요. Base URL FAQ에서 클라이언트 입력란과 경로 접미사를 설명합니다.