콘텐츠로 이동
무료 가입
AI 애플리케이션 플랫폼 설정

Cherry Studio에서 BetterToken 설정: 사용자 지정 공급자, API Host, 모델

Cherry Studio에 BetterToken을 OpenAI 호환 또는 Anthropic 호환 사용자 지정 공급자로 추가하고, Model ID를 등록하고, 연결을 확인하고, 자주 발생하는 오류를 해결합니다.

Cherry Studio를 BetterToken에 연결하려면 사용자 지정 공급자를 추가하고 BetterToken API Key와 API Host를 입력한 다음, 모델 목록에서 현재 Model ID를 추가합니다.

주요 설정

항목값
공급자 유형OpenAI (OpenAI 호환)
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai (API Host)
모델모델 목록에 있는 현재 사용 가능한 Model ID

사전 요구 사항

가입하고 BetterToken API Key 받기

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

설치

공식 웹사이트 또는 GitHub Releases에서 시스템에 맞는 Cherry Studio를 내려받아 설치하고 실행합니다. 추가 플러그인은 필요 없습니다.

수동 설정

모든 설정은 Cherry Studio 설정 화면에서 진행합니다. 설정 파일을 수정할 필요는 없습니다.

사용자 지정 공급자 추가

Settings → Model Provider를 열고 Add를 클릭한 뒤 BetterToken 같은 이름을 입력하고 공급자 유형으로 OpenAI를 선택합니다.

API Key와 API Host 입력

  • API Key → BetterToken API Key
  • API Host → https://bettertoken.ai

Cherry Studio는 요청 경로를 자동으로 붙입니다. 입력란 아래의 요청 URL 미리보기가 https://bettertoken.ai/v1/chat/completions인지 확인하세요. API Host에 /chat/completions가 포함된 전체 URL을 붙여 넣지 마세요.

모델 추가

Manage를 클릭해 모델 목록을 가져오거나 Add를 클릭해 Model ID를 직접 입력합니다. 예: claude-sonnet-5-5, gpt-6-sol, deepseek-flash.

연결 확인

Check를 클릭하고 추가한 모델 중 하나를 선택한 뒤 성공 메시지를 기다립니다. 그런 다음 공급자를 활성화합니다.

Anthropic 프로토콜 사용하기

Claude 모델의 경우 공급자 유형 Anthropic, API Host https://bettertoken.ai로 두 번째 사용자 지정 공급자를 추가할 수 있습니다. 이 경우 Cherry Studio는 /v1/messages로 요청을 보냅니다. 이 공급자는 Claude 모델에만 사용하세요. 다른 모든 모델에는 OpenAI 유형의 공급자를 사용하세요.

연결 확인

새 대화를 시작하고 모델 선택기에서 BetterToken 모델을 고른 뒤 한 단어로만 답하세요: OK를 보냅니다. 정상적인 답변이 오면 설정이 완료된 것입니다.

모델 전환

대화의 모델 선택기에서 다른 BetterToken 모델을 선택합니다. 목록에 없는 모델이라면 BetterToken 공급자를 열고 Add를 클릭한 뒤 모델 목록의 정확한 Model ID를 입력합니다.

자주 발생하는 오류

오류확인할 내용
401 / UnauthorizedBetterToken API Key를 확인하고 앞뒤 공백을 제거하세요.
404API Host가 https://bettertoken.ai인지, 요청 URL 미리보기에서 /v1/chat/completions가 한 번만 붙어 있는지 확인하세요.
model not found모델 목록에서 현재 Model ID를 복사하세요.
모델 목록이 비어 있음Add로 Model ID를 직접 추가하세요.

고급 설정

관련 가이드

기술 세부 정보

프로토콜과 엔드포인트

공급자 유형 OpenAI는 https://bettertoken.ai/v1/chat/completions로, Anthropic은 https://bettertoken.ai/v1/messages로 요청을 보냅니다. 두 경우 모두 API Host에는 https://bettertoken.ai만 입력합니다.