Cherry Studio를 CheapTokens에 연결하기: 커스텀 프로바이더, Base URL

Cherry Studio에서 CheapTokens를 사용하려면 커스텀 프로바이더를 추가하세요(Settings → Model Provider → Add Provider). OpenAI Base URL 필드에 https://api.cheaptokens.dev/v1/를 넣고, API 키를 붙여넣은 뒤 모델 id deepseek-ai/DeepSeek-V4-Flash-0731를 직접 추가하세요. 그다음 Model Check로 키를 확인하고 인사를 건네면 됩니다. 이게 전부입니다. 유일하게 발목 잡는 디테일은 URL 끝의 슬래시입니다.

데스크톱 채팅 앱을 여는 이유는 여러 모델과 그 뒤의 하나의 잔액을 한 창에서 쓰고 싶기 때문이지, 서비스마다 브라우저 탭을 열고 싶어서가 아닙니다. Cherry Studio는 바로 그 용도로 만들어졌습니다. Windows, macOS, Linux용 오픈소스 AI 워크스테이션(AGPL-3.0 Community Edition)으로 채팅, 에이전트, 지식 베이스를 갖추고 있으며, OpenAI 호환 서비스라면 무엇이든 커스텀 프로바이더로 받아들입니다. CheapTokens는 OpenAI Chat Completions 형식을 따르므로 잘 맞습니다. 아래 단계는 Cherry Studio 문서의 커스텀 프로바이더 페이지를 따르며, 2026년 11월 7일에 확인했습니다. 앱 자체는 바뀌므로 라벨이 옮겨졌다면 근처에서 같은 단어를 찾아보세요.

앱을 열기 전에 필요한 것#

세 가지, 모두 짧습니다:

• Base URL: https://api.cheaptokens.dev/v1/ (끝의 슬래시 포함 — 이유는 다음 섹션에 있습니다);
• CheapTokens 계정의 API 키. 복사할 수 있는 곳에 보관하고, 공유 메모에 붙여넣지 마세요;
• 전체 모델 id. 가격표의 짧은 이름은 API가 받지 않습니다. 게이트웨이 id를 사용하세요. 예를 들어 deepseek-ai/DeepSeek-V4-Flash-0731입니다. 다른 id는 list-models 가이드와 CheapTokens 문서에 있습니다.

커스텀 프로바이더 추가#

Settings(톱니바퀴 아이콘)를 열고 Model Provider로 가세요. 프로바이더 목록 맨 아래에 + Add Provider가 있습니다. 클릭하면 Add Custom Provider 대화상자가 나타납니다.

이렇게 채우세요:

Cherry Studio는 기본적으로 'OpenAI'와 'Anthropic' 엔드포인트 필드를 보여줍니다. 실제로 사용하는 프로토콜만 채우세요. 일반 채팅이라면 OpenAI 쪽이고, Anthropic 필드는 비워둘 수 있습니다. 각 Base URL 필드 아래에 앱이 최종 요청 경로의 미리보기를 보여줍니다. 읽어보세요. 무언가를 보내기 전에 잘못된 주소를 잡아내는 가장 빠른 방법입니다.

Add를 클릭해 저장하세요.

끝의 슬래시가 중요한 이유#

Cherry Studio는 문서의 세 가지 규칙에 따라 Base URL로 요청 URL을 만듭니다(2026년 11월 7일 확인):

• https://example.com 같은 루트 주소에는 /v1/chat/completions가 붙습니다;
• /로 끝나는 주소에는 chat/completions만 붙습니다;
• #로 끝나는 주소는 입력한 그대로 사용되며 아무것도 추가되지 않습니다.

CheapTokens는 /v1 아래에 있으므로, https://api.cheaptokens.dev/v1/chat/completions로 변환되는 형식은 https://api.cheaptokens.dev/v1/입니다 — API가 기대하는 경로입니다. 필드 아래 미리보기가 정확히 그렇게 표시되어야 합니다. /v1/v1/가 보이거나 /v1가 아예 없다면 계속하기 전에 필드를 고치세요.

키, 모델, Model Check#

프로바이더 페이지로 돌아오면 다섯 가지 작은 단계가 있습니다. 이 순서대로 하세요:

5단계에 대한 참고. 페이지에는 서비스에서 모델 목록을 가져오는 Sync models 버튼도 있습니다. 신뢰할 수 있는 방법은 **+**로 id를 직접 추가하는 것입니다. deepseek-ai/ 부분을 포함해 deepseek-ai/DeepSeek-V4-Flash-0731를 정확히 입력하세요. 추가할 수 있는 모델:

Model Check는 키 필드 옆의 버튼입니다. Cherry Studio 문서에 따르면 키가 유효한지 확인합니다. 문제가 있다고 하면 아래 오류 섹션으로 가세요. 원인은 보통 세 필드 중 하나입니다.

첫 메시지 보내기#

새 채팅을 열고, 상단의 모델 선택기에서 CheapTokens 프로바이더와 추가한 모델을 고른 뒤 'Explain what a token is in two sentences.'처럼 짧은 글을 쓰세요. 모델의 응답이 오면 키, 주소, 모델 id까지 전체 체인이 작동하는 것입니다.

앱 없이 요청을 보고 싶나요? 다음은 순수한 Chat Completions 호출입니다:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

응답은 텍스트가 choices[0].message.content에, 토큰 수가 usage에 담긴 JSON입니다.

데스크톱 채팅에는 어떤 모델을 넣을까#

채팅 창은 에이전트 루프와 다른 작업입니다. 묻고, 읽고, 다시 묻습니다. 그때 중요한 것은 두 가지입니다. 답변이 얼마나 길 수 있는지, 그리고 대화가 얼마나 크게 들어가는지입니다.

• DeepSeek-V4-Flash — 일반 채팅과 긴 문서의 기본 선택: 답변당 최대 32,768 출력 토큰, 380K 컨텍스트, 시간대와 무관한 단일 가격. 입력과 출력을 합산하면 OpenRouter보다 저렴합니다.
• GLM-5.3-Flash — 세 모델 중 가장 큰 창(390K)을 가진 일상 채팅, 입력과 출력 모두 OpenRouter보다 저렴합니다.
• MiniMax-M2.7 — 180K 컨텍스트의 채팅 및 에이전트 스타일 작업, 양쪽 모두 OpenRouter보다 저렴합니다.

세 모델 모두 하나의 잔액 뒤에 있으므로, 세 id를 같은 프로바이더에 추가하고 키를 건드리지 않은 채 모델 선택기에서 전환할 수 있습니다.

채팅 세션 비용#

대략적인 그림입니다. 20개 메시지 대화가 있다고 합시다. 매 메시지가 이전 기록을 다시 보내므로 요청당 평균 약 6,000 입력 토큰과 500 출력 토큰입니다(긴 채팅이 더 비싼 이유에서 다룬 이유입니다). DeepSeek-V4-Flash에서 요청 하나는 $0.00014입니다. 그중 20개가 아래 계산기에 있습니다. 슬라이더를 자신의 채팅에 맞게 움직이세요.

아래 표는 같은 세션을 모든 모델에서 실행한 것이며, 비교를 위해 OpenRouter 열이 있습니다:

1M 토큰당 현재 가격은 CheapTokens 가격을 참고하세요.

작동하지 않으면#

대부분의 문제는 같은 세 필드에서 나옵니다: 키, URL, 모델 id. 보이는 것을 원인과 맞춰보세요:

이 오류들에 대한 더 긴 설명은 API 401 또는 404: 잘못된 키, base URL 또는 모델 id를 참고하세요. 데스크톱 앱 대신 브라우저 기반 채팅을 선호한다면 Open WebUI도 같은 방식으로 작동합니다.

출처: Cherry Studio 문서, 커스텀 프로바이더 및 프로바이더 설정 페이지, 2026년 11월 7일 확인; 프로젝트는 github.com/CherryHQ/cherry-studio에 있습니다.