Cherry Studio

Cherry Studio의 OpenAI 기본 주소와 모델 목록을 구성합니다.

설치 및 준비

Cherry Studio 릴리스에서 Windows, macOS, Linux 설치 파일을 받아 실행합니다. routerra.ai/keys에서 클라이언트용 키를 만들고 게이트웨이 모델 목록에서 허용된 ID를 복사합니다. Docker나 로컬 추론 서버는 필요 없으며 키는 클라이언트 공급자 설정에 저장됩니다.

연결 구성

Settings → Model Services → + Add Provider에서 이름을 routerra.ai로 정하고 OpenAI 엔드포인트의 기본 주소 https://routerra.ai/v1과 YOUR_API_KEY를 입력합니다. API Address가 표시되는 버전에서는 https://routerra.ai/v1을 사용하고 요청 URL 미리보기가 /v1/chat/completions인지 확인합니다. 최신 버전은 프로토콜별 엔드포인트를 제공하므로 Anthropic이나 Responses가 아닌 OpenAI 채팅을 구성합니다. 저장하고 공급자를 활성화합니다.

OpenAI base URL: https://routerra.ai/v1
API Key: YOUR_API_KEY
Model ID: YOUR_MODEL_ID
Generated chat URL: https://routerra.ai/v1/chat/completions

모델 선택 및 오류 해결

Get model list로 허용된 모델을 추가하거나 +로 YOUR_MODEL_ID를 직접 추가합니다. 새 채팅에서 공급자와 모델을 선택해 짧은 문장을 보냅니다. 404가 발생하면 최종 URL의 /v1 중복이나 /chat/completions 누락을 확인하세요. 목록이 비어 있으면 공급자 활성화 상태를 확인하고 ID를 직접 추가합니다. 키 검사 성공이 모든 모델의 접근 권한을 보장하지는 않습니다.