Cherry Studio
Cherry Studio를 RunAPI에 연결하고 채팅을 확인합니다.
사용자 지정 OpenAI 공급자로 Cherry Studio를 RunAPI에 연결합니다. 계속하기 전에 인증 가이드에서 표준 RunAPI API 키를 만드십시오.
Cherry Studio 설치
공식 Cherry Studio 다운로드 가이드에 따라 데스크톱 애플리케이션을 설치한 후 설정을 여세요.
RunAPI 제공자 추가
- 설정 -> 모델 서비스 -> + 추가를 엽니다.
- 제공자 이름을
RunAPI로, 제공자 유형을 OpenAI로 설정합니다. - RunAPI API 키를 입력하고 API 주소를
https://runapi.ai/v1으로 설정합니다. - 모델 카탈로그에서 정확한 모델 식별자를 추가하고 제공자를 활성화한 후 저장합니다.
공급자 유형이 OpenAI이므로 이 필드는 /v1을 포함하는 RunAPI의
OpenAI 호환 Base URL을 사용합니다. Cherry Studio는 Chat Completions 요청 시
/chat/completions를 추가하므로 API 주소 필드에 전체 작업 URL을 붙여넣지 마십시오.
모델 선택
커스텀 제공자는 사용자가 추가한 모델에 의존합니다. 선택기가 비어 있으면 제공자의 모델 관리 영역으로 돌아가 RunAPI 식별자를 직접 추가하세요. 모델을 추가해도 해당 모델이 지원하지 않는 기능이 부여되지는 않습니다.
연결 확인 실행
저장된 모델로 연결 확인을 실행하세요. 이는 키 형식만 검증하는 것이 아니라 모델 요청을 전송합니다. 확인에 성공하면 공급자 URL, 키, 선택한 모델이 함께 작동함을 확인합니다.
연결 확인
새 채팅을 시작하고 RunAPI 공급자와 모델을 선택한 후 Reply
with the word connected.를 전송하세요. 정상적인 완전한 또는 스트리밍 응답은 활성 채팅이 RunAPI를 사용하고 있음을 확인합니다.
문제 해결
- 모델 선택기가 비어 있음: 사용자 정의 공급자의 모델 관리 영역에 정확한 모델 식별자를 추가하고 공급자가 활성화되어 있는지 확인하세요.
- 연결 확인 실패: 모델이 선택되어 있는지 확인하고, 유효한 표준 키로 교체한 후 다시 시도하세요.
- 요청에서
404반환: API 주소로https://runapi.ai/v1을 사용하세요./chat/completions를 직접 추가하지 마세요. - Text는 작동하지만 vision 또는 tools 실패: Model Catalog에서 필요한 기능을 선언하는 모델을 선택하세요.
공유 프로토콜 동작에 대해서는 LLM API 빠른 시작을 참조하세요. 요청 및 응답 필드에 대해서는 Chat Completions API 참조를 참조하세요.