Cherry Studio

Settings → Model Services → 사용자 지정 제공자: 키와 API 주소를 붙여넣고 Get Model List를 클릭하면 전체 카탈로그가 선택기에 채워집니다

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 设置 → 模型服务 (설정 → 모델 서비스)을 열고 添加自定义提供商 (사용자 지정 공급자 추가)를 선택합니다.
3. API 密钥 (API 키)와 OpenAI 엔드포인트 필드(https://api.kunavo.com/v1)를 입력합니다.
4. Anthropic 필드(https://api.kunavo.com)도 입력합니다. 이 필드는 端点设置 (엔드포인트 설정)의 OpenAI 아래에 있습니다. Cherry Agent와 Anthropic Messages 프로토콜을 통해 라우팅되는 모델은 OpenAI 필드가 아니라 이 필드의 값을 사용합니다. 다른 엔드포인트 유형은 更多设置 (추가 설정)에서 확인할 수 있습니다.
5. 저장한 다음 공급자의 모델 목록에서 同步模型을 눌러 원하는 채팅 모델을 추가합니다. 检测을 눌러 모델이 처음부터 끝까지 작동하는지 확인합니다.
6. 모델을 전역으로 지정하지 말고 어시스턴트별로 할당하세요. Cherry Studio는 어시스턴트마다 모델을 유지하므로 저렴한 기본 모델과 고가의 전문 모델을 함께 사용할 수 있습니다.

Cherry Studio 공급자 문서에서 확인했습니다(2026년 10월 1일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Cherry Studio에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.