메인 콘텐츠로 건너뛰기
Cherry Studio는 여러 모델 프로바이더를 하나의 화면에서 관리할 수 있는 데스크톱 클라이언트입니다. 글로벌 에디션에는 AiHubMix가 기본 제공됩니다.

Cherry Studio 다운로드

Cherry Studio 다운로드

AIHubMix 구성하기

  1. 설정 → 모델 서비스를 열고 AiHubMix를 선택한 뒤 오른쪽 위의 스위치를 켭니다.
    모델 서비스에서 AiHubMix 선택
  2. API 주소는 https://aihubmix.com/v1로 둡니다.
    API 주소는 aihubmix.com/v1
  3. API 키에 이 사이트의 키를 입력하고 검사를 클릭합니다.
    API 키를 입력하고 연결 검사
    검사에 실패하면 VPN을 끄고 다시 시도하세요.
  4. 모델 동기화를 클릭해 모델을 추가하거나 **+**를 클릭해 모델 ID를 직접 입력합니다.
    모델 동기화 또는 수동 추가
    모델 ID와 이름을 입력하는 추가 화면
  5. 설정 → 기본 모델을 열고 어시스턴트, 빠른 작업, 번역에 사용할 모델을 선택합니다.
    기본 모델 선택

대화 시작하기

홈으로 돌아가 상단의 모델 선택기에서 추가한 모델을 선택하면 대화를 시작할 수 있습니다.

자주 묻는 질문

모델이 이미지를 인식하지 못함

설정 → 모델 서비스에서 해당 모델의 편집 화면을 열고 입력 모달리티에서 시각을 켭니다.

Claude 모델 호출 시 AI_APICallError 반환

오류 메시지의 요청 주소가 https://aihubmix.com/anthropic/v1/messages인지 확인합니다. 해당한다면 공급자의 Anthropic 엔드포인트 설정에서 주소를 https://aihubmix.com으로 변경합니다.

Claude 프롬프트 캐싱 활성화하기

AiHubMix 공급자 페이지에서 API 설정을 열고 필요에 따라 다음 항목을 설정합니다.
  • 캐시 토큰 임계값: 이 토큰 수를 넘는 메시지만 캐시합니다. 0으로 설정하면 캐시하지 않습니다
  • 시스템 메시지 캐싱: 시스템 프롬프트를 캐시할지 여부
  • 최근 N개 메시지 캐싱: 최근 N개 대화 메시지를 캐시합니다(시스템 메시지 제외)
  • 캐시 기간: 5분 또는 1시간. 1시간 캐시 쓰기는 비용이 더 높습니다
설정하면 Cherry Studio가 Claude 모델에 cache_control을 자동으로 주입합니다. 각 항목의 설명은 Claude 프롬프트 캐싱을 참고하세요.
마지막 업데이트: 2026-11-04