https://api.tokios.com/v1을(를) 지정하고, sk-tok-… 키를 붙여넣으며, Tokios 배포 이름을 모델로 추가하면, 호스팅된 공급자가 아닌 자체 하드웨어에서 실행되는 모델과 Cherry Studio에서 대화할 수 있습니다.
사전 요구 사항
커넥터 페어링 완료
Cherry Studio가 접근하려는 모델 옆에
tokios-connector를 설치하고 페어링합니다.모델 등록 완료
해당 모델에 대한 배포(공개 이름)를 등록합니다.
API 키 생성 완료
해당 배포에 범위가 제한된
sk-tok-… 키를 생성합니다.지원되는 백엔드
로컬 백엔드(Ollama, llama.cpp, vLLM, LM Studio)가 실행 중인지 확인합니다.
Cherry Studio에 Tokios 공급자 추가
1
모델 공급자 설정 열기
메뉴에서 Settings 메뉴를 열고 Model Services 탭으로 이동합니다. 일부 빌드에서는 이를 Model Provider로 표시합니다. Cherry Studio의 문서는 중국어에서 번역되었으므로 정확한 표기는 버전마다 다를 수 있습니다.
2
공급자 추가
먼저 + Add를 클릭합니다. Add Provider 대화 상자에서 Provider name(예:
Tokios)을(를) 입력하고 Provider type을 OpenAI로 설정합니다. 이는 모든 범용 OpenAI 호환 엔드포인트에 대한 설정입니다.3
API 주소 및 키 설정
공급자 필드를 다음과 같이 채웁니다:
반드시
/v1을 API address에 직접 포함시킵니다. Cherry Studio는 사용자 지정 공급자에 대해 경로를 신뢰할 수 있게 추가하지 않으므로, 전체 /v1 베이스를 제공해야 합니다.4
배포를 모델로 추가
Cherry Studio는 사용자 지정 공급자에 대해 모델을 자동으로 목록에 표시하지 않습니다. 공개 배포 이름을 사용하여 수동으로 추가합니다. Models 탭에서 등록한 이름이며, 예를 들어
gemma-tunnel입니다. 이는 Cherry Studio가 model 필드에서 전송하는 값이며, Ollama, llama.cpp, vLLM 또는 LM Studio의 로컬 모델 ID가 아닙니다.예시
gemma-tunnel은 등록한 배포 이름으로, sk-tok-YOUR_KEY는 자체 키로 교체합니다. 이 둘 중 어느 것도 공유 구성 파일에 커밋하지 마십시오.데스크톱 앱, 모델은 다른 위치
이 설정이 해결하는 일반적인 시나리오는 다음과 같습니다. Cherry Studio는 노트북이나 데스크톱에서 실행되지만, 원하는 모델(해당 머신이 실행할 수 있는 것보다 큰 모델)은 다른 곳의 워크스테이션이나 서버에 있습니다. 해당 모델 옆의 커넥터가 Tokios로 아웃바운드 연결을 설정하고, Cherry Studio는https://api.tokios.com/v1 키와 함께 sk-tok-…을(를) 호출합니다. 입력 중인 머신에 로컬로 있지 않은 모델과 함께 Cherry Studio의 UI를 유지할 수 있으며, 인바운드 포트나 VPN이 필요하지 않습니다.
문제 해결
401 오류
401 오류
Cherry Studio가 전송한 API 키가 누락되었거나, 형식이 잘못되었거나, 취소되었습니다. 추가 공백 없이 전체
sk-tok-… 키를 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인합니다.404 오류
404 오류
Cherry Studio가 전송한 모델 값이 등록된 배포와 일치하지 않거나, API address에
/v1이(가) 누락되었습니다. 모델 이름이 Models 탭의 공개 이름과 일치하는지, 주소가 https://api.tokios.com/v1인지 확인합니다.503 오류
503 오류
해당 배포의 커넥터가 오프라인 상태이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인합니다. 커넥터는 Online로 표시되어야 하며, 이를 실행하는 머신이 여전히 가동 중이고 접근 가능해야 합니다.
다음 단계
호환 클라이언트
다른 OpenAI 및 Anthropic 호환 클라이언트의 기본 URL 및 키 설정을 참조하십시오.
API 키
팀원 및 에이전트를 위한
sk-tok-… 키를 생성, 범위 지정 및 순환합니다.