Cherry Studio에 프로바이더 하나로 카탈로그의 모든 모델 추가하기.

빠른 답: Model Services의 프로바이더 하나.

Cherry Studio 왼쪽 내비게이션의 톱니바퀴 아이콘을 클릭하고, Model Services 탭을 열고, 프로바이더 목록 아래의 Add 버튼을 클릭하세요. 알아보기 쉬운 이름(APIsRouter)을 붙이고 프로바이더 유형으로 OpenAI를 선택한 다음 저장하세요. 이제 목록에서 새 프로바이더를 선택해 설정하세요: 활성화 스위치를 켜고, API 키 필드에 키를 붙여넣고, API 주소를 https://api.apisrouter.com으로 설정하세요. 형태에 주의하세요: Cherry Studio의 문서화된 기본 동작은 루트 주소를 받아 자체적으로 /v1/chat/completions를 덧붙이는 것이므로, /v1 없이 호스트만 입력합니다. 그다음 모델 섹션의 Add 버튼으로 모델을 추가하세요. 항목마다 정확한 카탈로그 id 하나씩(claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), 그리고 키 옆의 Check 버튼을 눌러 선택한 모델로 실시간 검증을 실행하세요.

Provider name:  APIsRouter
Provider type:  OpenAI

then, on the provider page:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → success

Cherry Studio가 요청 URL을 구성하는 방법.

Cherry Studio(GitHub의 CherryHQ, 약 4.9만 스타)는 Windows, macOS, Linux용 중국 출신 데스크톱 클라이언트로, 수백 개의 프로바이더와 어시스턴트 프리셋을 제공하는 것으로 유명합니다. 프리셋 목록에 없는 것은 위에서 설명한 커스텀 프로바이더 흐름을 통해 들어가며, 이해할 가치가 있는 부분은 API 주소 필드입니다. 문서화된 기본 동작: 루트 주소를 입력하면 Cherry Studio가 그 위에 OpenAI 경로를 이어 붙여서, 실제 통신에서는 https://api.apisrouter.com이 https://api.apisrouter.com/v1/chat/completions가 됩니다. 프로바이더가 비표준 경로를 쓴다면, 주소 끝에 #을 붙이면 이어 붙이기가 완전히 비활성화되어 입력한 그대로 주소가 사용되는데, 이것이 문서화된 탈출구입니다. 후행 슬래시 관련 이어 붙이기 동작은 버전마다 바뀌어 왔으므로, 요청이 404가 나면 추측하는 대신 오류에 나온 최종 URL을 읽어보세요. 표준 /v1 게이트웨이에는 루트 주소 형태와 자동 이어 붙이기가 안정적인 설정입니다. 설정을 마치면, 모든 대화가 추가한 모델 id를 그대로 문자열로 담아 표준 chat completions를 전송합니다. 벤더가 무엇이든 통신 형식에는 상관없으며, 이 덕분에 프로바이더 항목 하나가 중국과 서구 카탈로그 id를 함께 담을 수 있습니다.

알아둘 가치가 있는 세부사항: 멀티 키와 모델 관리.

API 키 필드는 키를 하나 이상 받아들입니다: 영문 쉼표로 키를 구분하면 Cherry Studio가 요청마다 위에서 아래로 순서대로 돌아가며 사용하는데, 이는 문서화된 로드 밸런싱 기능입니다. 키별로 계측하는 게이트웨이에서는 이것이 용도 구분 역할도 겸합니다: 업무용 키 하나, 개인용 키 하나, 하나만 나열하면 로테이션이 꺼집니다. 모델 항목은 수동 등록이며, 이는 오히려 장점입니다. Cherry Studio는 추가한 것만 정확히 보여주므로, 피커가 가져온 카탈로그에 파묻히지 않고 엄선된 상태를 유지합니다. 각 항목은 id를 그대로 통신 문자열로 사용하며, Manage 버튼으로 나중에 항목을 수정하거나 삭제할 수 있습니다. 관련 id를 일관된 이름으로 묶으면 피커가 메뉴처럼 읽힙니다: 빠른 티어(deepseek-v4-flash, claude-haiku-4-5-20251001), 지역 강점(glm-5.2, qwen3.7-plus, kimi-k2.6), 프론티어(claude-sonnet-4-6). Check 버튼은 선택한 모델을 기준으로 키와 주소 쌍을 검증하며, 실제 대화 전에 프로바이더를 확인하는 가장 빠른 방법입니다. 키가 올바른데도 검사가 실패한다면 거의 항상 주소 필드에 경로를 중복시키는 불필요한 /v1이 들어 있다는 뜻입니다.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model list

데스크톱 일꾼을 위한 모델 선택.

키 하나면 비교는 피커 전환일 뿐입니다. 같은 일주일간의 작업을 두 후보 id로 돌려보고, APIsRouter 콘솔의 모델별 지출이 여러분이 직접 판단한 결과 품질과 함께 심판 역할을 하게 하세요.

• 일상적인 채팅과 빠른 재작성은 빠른 티어에 맡기세요: deepseek-v4-flash와 claude-haiku-4-5-20251001은 항상 열어두는 창이 부담 없게 느껴지도록 해줍니다.
• 중국어 작업에서는 지역 id들이 제 자리를 확실히 차지합니다: 초안과 문서 작업에는 glm-5.2와 qwen3.7-plus, 긴 컨텍스트 읽기에는 kimi-k2.6.
• claude-sonnet-4-6은 수정 없이 그대로 전달하는 대화를 맡습니다: 신중한 분석, 고객에게 보여줄 문장, 실제로 배포할 코드.
• Cherry Studio의 어시스턴트는 역할별로 자신만의 모델을 고정할 수 있으므로, glm-5.2를 쓰는 번역 어시스턴트와 claude-sonnet-4-6을 쓰는 코딩 어시스턴트가 프로바이더 하나 뒤에서 공존합니다.
• 행은 신중하게 추가하세요. 엄선된 6개 모델 피커는 실제로 쓰이지만, 통째로 붙여넣은 카탈로그는 그냥 스크롤되어 지나칩니다.

사용한 만큼 지불 · 공식 요금보다 저렴

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Cherry Studio 특유의 실패 패턴.

가장 많이 보고되는 것은 경로 중복입니다: /v1/chat/completions를 덧붙이는 필드에 https://api.apisrouter.com/v1을 붙여넣으면 /v1/v1 URL이 만들어져 404가 납니다. 루트 주소를 입력하고 경로 구성은 클라이언트에 맡기세요. 정확한 URL을 고정해야 한다면, 그것을 위한 후행 # 형태가 있습니다. 키는 올바른데 Check가 실패한다면 대개 위에서 설명한 주소 형태 문제입니다. 주소는 깔끔한데 Check가 실패한다면 키 문제이며, 여러 키는 반드시 영문 쉼표로 구분해야 한다는 점에 유의하세요. 중국어 입력기에서 붙여넣은 전각 문자는 목록을 조용히 망가뜨립니다. 다른 모델은 작동하는데 특정 모델만 오류가 난다면 id 철자 문제입니다. 항목은 자유 입력 텍스트이며 /v1/models 목록이 정답 출처입니다. 그리고 설정은 컴퓨터별이라는 것을 기억하세요: 데스크톱에 설정한 프로바이더는 2분짜리 설정을 반복하거나 Cherry Studio 자체 백업 기능을 쓰지 않는 한 노트북에는 존재하지 않습니다. 버전 변화 참고: Cherry Studio는 자주 업데이트되며 설정 레이블도 바뀝니다(일부 빌드에서는 Model Services가 Model Provider로 나타나기도 했습니다). 프로바이더 추가, OpenAI 유형 선택, 키, 주소, 모델이라는 흐름 자체는 안정적으로 유지되어 왔습니다.

어떤 사람들이 게이트웨이를 통해 Cherry Studio를 쓰는가.

• GLM, Qwen, Kimi, DeepSeek을 Claude, GPT와 함께 하나의 피커, 하나의 잔액으로 섞어 쓰며, 벤더별 계정이 필요 없는 이중언어 데스크톱 사용자.
• 이미 사용 중인 지역 모델과 나란히, 서구권 카드 없이 선불 잔액으로 Claude와 GPT id를 쓰고 싶은 아시아 지역 사용자.
• 역할별로 Cherry Studio 어시스턴트를 운영하며, 키 다섯 개를 관리하지 않고도 각 어시스턴트를 알맞은 벤더에 고정하고 싶은 파워 유저.
• 이미 다른 도구를 게이트웨이로 라우팅하고 있으며 데스크톱 클라이언트도 같은 키와 사용량 로그로 관리하고 싶은 사람들.
• 벤치마크가 아니라 실제 일상 업무에서 지역 모델과 서구권 모델을 비교하는 사람 — 각 후보는 모델 행 하나면 됩니다.

엔드포인트 검증 및 첫 대화 디버깅.

먼저 모델 목록을 curl로 확인하고 추가할 id를 복사하세요. 그다음 사용하려는 일상용 모델로 chat completion 하나를 실행해 보세요. 둘 다 성공하면, 남은 문제는 모두 프로바이더 페이지에 있습니다. Cherry Studio 안에서는 채팅 전에 Check를 실행하세요. 인증 실패는 키 필드나 쉼표 구분자 문제입니다. 404는 주소 형태 문제이니, 오류에 나온 구성된 URL을 읽고 /v1 구간이 몇 개인지 세어보세요. 특정 모델에서의 not-found 오류는 그 행의 id 철자 문제입니다. 대화가 순조롭게 흐르면, APIsRouter 콘솔이 요청별 모델, 토큰 수, 지출을 보여줍니다. 근무일 내내 사용하는 데스크톱 클라이언트는 작은 요청들이 꾸준히 이어지는 흐름을 만들어내며, 키별 사용량 뷰가 그 흐름을 모델별·일별 숫자로 바꿔주고, 중국과 서구 id가 한 페이지에 함께 나타납니다.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

자주 묻는 질문