Cherry Studio 연결

Cherry Studio에 1折AI를 사용자 지정 서비스 제공자로 추가하고, Anthropic 또는 OpenAI 엔드포인트를 선택한 후 루트 주소, API 키, 모델을 입력합니다.

Cherry Studio는 데스크톱용 AI 대화 클라이언트로, 1折AI를 사용자 지정 서비스 제공자로 추가할 수 있습니다.

원클릭 가져오기

콘솔의 API 키 → 사용 도구 → Cherry Studio에서 Anthropic 또는 OpenAI 프로토콜을 선택하고 Cherry Studio 열기를 클릭합니다. 앱 내에서 가져오기를 확인한 후 모델을 가져오고 서비스 제공자를 활성화하고 테스트합니다. 동일한 이름의 구성이 이미 있는 경우 덮어쓰기 경고를 확인합니다. 가져오기 링크에는 전체 키가 포함되어 있으므로 전달하지 마세요.

브라우저는 앱이 설치되어 있는지 확인할 수 없습니다. 호출되지 않으면 먼저 클라이언트를 설치하고 한 번 실행하거나 아래의 수동 단계를 사용하세요. 프로토콜 형식은 공식 구현을 확인했지만 실제 추론은 실제 버전과 모델에 따라 검증해야 합니다.

구성

서비스 제공자 추가
설정(톱니바퀴 아이콘) → 모델 서비스 → 목록 하단의 + 서비스 제공자 추가.
정보 입력

필드 입력 내용
제공자 이름 1折AI
API 키 sk-你的Key
엔드포인트 Anthropic(권장) 또는 OpenAI 선택
API 주소 https://1zheai.com
API 주소에는 루트 주소만 입력하세요. Cherry Studio는 선택한 프로토콜에 따라 /v1/...을 자동으로 추가합니다. /v1/messages, /v1/chat/completions 같은 전체 경로를 붙여넣지 마세요. 끝에 #을 추가하지 마세요(#로 끝나면 경로가 자동으로 추가되지 않습니다).
모델 추가
모델 목록 가져오기를 클릭하고 반환된 목록에서 사용할 모델을 추가하거나, **+**를 클릭하여 모델 ID를 직접 입력하세요(예: claude-sonnet-5-5). 목록에 추가된 모델만 대화의 모델 선택에 표시됩니다.
활성화 및 테스트
서비스 제공자 페이지 오른쪽 상단의 활성화 토글을 켜고, 대화 화면으로 돌아가 1折AI 아래의 모델로 메시지를 보내세요.

필드	입력 내용
제공자 이름	`1折AI`
API 키	`sk-你的Key`
엔드포인트	Anthropic(권장) 또는 OpenAI 선택
API 주소	`https://1zheai.com`

Anthropic 엔드포인트와 OpenAI 엔드포인트 중 선택

엔드포인트	적합한 경우
Anthropic	extended thinking 등 Claude의 네이티브 기능을 사용하고 싶을 때; Agent의 프로토콜 제한은 현재 버전을 기준으로 합니다
OpenAI	OpenAI 형식에 익숙하거나 다른 OpenAI 호환 서비스와 통합 관리하고 싶을 때

두 엔드포인트는 동일한 API 키(API key)와 동일한 모델 ID 세트를 사용합니다.

자주 묻는 질문

모델 목록을 가져오지 못함?

먼저 API 키에 불필요한 공백이 없는지 확인하세요. 그다음 API 주소가 https://1zheai.com인지, 경로가 과도하게 입력되지 않았는지 확인하세요. 가져오지 못해도 사용에는 영향이 없으며, 모델 ID를 직접 입력해도 사용할 수 있습니다.

대화에서 404 오류?

API 주소에 전체 경로를 입력했거나 끝에 #을 추가한 경우입니다. 루트 주소 https://1zheai.com로 되돌리세요.