Cherry Studio에서 BeatAPI 사용하기
Cherry Studio에서 BeatAPI 사용하기
Cherry Studio는 여러 제공자를 나란히 사용할 수 있는 데스크톱 채팅 클라이언트입니다. BeatAPI를 OpenAI 유형 제공자로 추가한 뒤, 계정에서 사용할 수 있고 Chat Completions를 지원하는 모델을 선택하세요. 선택 목록에 모델이 있다고 해서 선택한 제공자 유형과 호환된다는 보장은 없습니다.
사전 준비
- Cherry Studio 설치 — 공식 사이트에서 받으세요.
- BeatAPI API 키 — 대시보드 → API Keys에서 만드세요.
1단계: 제공자 설정 열기
오른쪽 위의 설정 아이콘을 클릭하거나 Ctrl+,(macOS에서는 Cmd+,)를 누른 다음 왼쪽 메뉴에서 Model Service를 선택하세요.
2단계: BeatAPI를 제공자로 추가
모델 서비스 페이지 아래쪽에서 + Add를 클릭하고 다음을 입력하세요.
Confirm을 클릭하세요. 오른쪽 설정 패널에 다음을 입력합니다.
/v1 접미사나 뒤쪽 경로 없이 https://api.beatapi.io를 입력하세요. Cherry Studio가 /v1/chat/completions를 직접 붙이므로, /v1을 직접 추가하면 /v1/v1/chat/completions가 되어 메시지마다 404 오류가 발생합니다.
오른쪽 위의 BeatAPI 제공자 토글이 켜져 있는지(초록색) 확인하고, 모델을 추가하기 전에 Test 버튼으로 연결을 확인하세요.
3단계: 모델 추가
제공자를 설정했으면 Models 섹션에서 Manage를 클릭해 모델 선택 창을 여세요. 원하는 ID를 검색하고 **+**를 클릭해 추가합니다.
전체 목록은 텍스트 API 페이지와 가격 페이지에 있습니다. 원하는 만큼 추가할 수 있으며, 채팅 헤더의 드롭다운에서 전환합니다.
4단계: 대화하기
메인 창으로 돌아가 **+**로 새 채팅을 시작하고, 위쪽의 모델 선택기를 클릭해 BeatAPI 제공자 아래의 모델을 고르세요.
자주 묻는 질문
Cherry Studio가 연결되지 않음
- API URL은
/v1없이https://api.beatapi.io여야 합니다. - 키가 활성 상태여야 합니다. 대시보드 → API Keys에서 확인하세요.
- 제공자 토글이 켜져 있어야 합니다.
모델 목록이 비어 있거나 갱신되지 않음
모델 관리자에서 ID로 모델을 직접 추가하세요. ID는 가격 페이지에 있으며 대소문자를 구분합니다.
대화 중 오류
사용량과 지출 확인
대시보드에서 API 키별 호출 수, 토큰, 비용을 볼 수 있습니다. GET /v1/usage에서도 같은 수치를 받을 수 있습니다.
지원
대시보드에서 지원 티켓을 열고 실패한 응답의 request_id를 함께 보내 주세요.