Cherry Studio
아래 프로토콜 값을 그대로 사용하고 저장 뒤 클라이언트를 다시 시작한 다음, 긴 작업, tool 또는 media를 켜기 전에 짧은 비공개 요청 하나를 검증하세요.
시작 전
현재 공식 배포처에서 제공하는 클라이언트 버전만 설치하세요. 로컬 구성을 변경하기 전에 콘솔에서 전용 API Key를 만들고 개인용, 공유용 또는 운영 배포용 Key를 재사용하지 마세요.
Windows, macOS 및 Linux
- Windows: 현재 Windows 설치 관리자 또는 PowerShell 절차를 사용하고 구성 파일을 바꾼 뒤 모든 클라이언트 프로세스를 종료하세요.
- macOS: CPU에 맞는 서명 앱 또는 공식 터미널 설치 관리자를 사용하세요. 홈 디렉터리 설정은 해당 macOS 사용자에게 속합니다.
- Linux / WSL: 배포판 또는 공식 CLI의 현재 지침을 따르세요. WSL은 Windows 프로필이 아니라 Linux 홈 디렉터리를 읽습니다.
모델 선택
전용 Key로 GET /v1/models를 호출하고 반환된 data[].id 하나를 선택하세요. Key 범위 목록이 기준이며 이전 구성, 글, 클라이언트 선택기는 접근을 보장하지 않습니다.
구성
text
Provider protocol: OpenAI-compatible
Base URL: https://ai.tavonilo.com/v1
API key: sk-your-own-key
Model ID: copy one id from GET /v1/models검증
Key를 /v1/models로 확인하고 민감하지 않은 작은 요청을 한 번 실행하세요. 지원 요청에는 시간, 경로, 모델, HTTP 상태, request ID만 남깁니다. 시간 초과가 과금 생성이 처리되지 않았다는 뜻은 아니므로 긴 생성이나 이미지 요청을 무조건 재전송하지 마세요.
안전한 복구
- 401: 불완전하거나 폐기되었거나 잘못된 Key를 교체하세요. 지원 요청에 Key를 붙이지 마세요.
- 403: Key 그룹, 모델 표시, 잔액, route 권한을 확인하세요.
- 404: 여기에 표시된 Base URL을 사용하고 완전한 endpoint를 넣거나 /v1을 두 번 붙이지 마세요.
- 429: 작업을 대기열에 넣고 있으면 Retry-After를 따르세요. 배치를 동시 재전송하지 마세요.
- 5xx 또는 timeout: 안전하게 재시도할 수 있는 작업만 제한적으로 재시도하세요. 시간, route, model, HTTP status, request ID를 마스킹 로그에 남기세요.
자격 증명 경계
장치 또는 워크로드마다 Key를 분리하세요. API Key, auth.json, 전체 비공개 프롬프트, 비밀번호, 인증 코드, 결제 정보를 지원팀에 보내지 마세요. 노출이 의심되면 Key를 즉시 폐기하고 교체합니다.