모델 연결 문제
연결 테스트 실패
- 설정 → 모델을 열고 구성을 편집한 뒤 연결 테스트를 클릭합니다.
- API 키가 유효한 리터럴인지, 또는 이 기기에서 환경 변수가 export되었는지 확인합니다.
- Base URL 재정의를 사용하는 경우 경로 세그먼트 중복 및 프록시 필요 여부를 확인합니다.
- 기업 네트워크는 벤더 도메인(예:
api.openai.com)을 차단할 수 있습니다.
일반적인 오류
| 증상 | 해결 |
|---|---|
| 401 / Invalid API Key | BYOK: 키 재생성 후 구성 업데이트; Newton: 다시 로그인 |
| 402 / insufficient balance | Newton: Dashboard 또는 top-up 열기 |
| 404 / model not found | 모델 ID 및 계정 액세스 확인; Newton은 모델 목록 새로고침 |
| 429 / rate limit | 동시성 낮추기 또는 벤더/모델 전환 |
| 타임아웃 / 서비스 사용 불가 | 네트워크, 프록시, Base URL 확인; Newton은 나중에 재시도하거나 BYOK로 전환 |
Newton 전용 확인
- 데스크톱이 Mystilink에 로그인되어 있는지 확인(활성화 코드만으로는 부족).
- 세션이 만료되었으면 다시 로그인하고 모델을 새로고침합니다.
- 잔액이 0이거나 부족하면 먼저 충전 — Newton billing.
- 가이드: Newton LLM.
기본 모델 사용 불가
자동 대체가 켜져 있으면 최소 두 개의 작동하는 구성을 유지하세요. 그렇지 않으면 다른 구성을 기본으로 임시 설정합니다(Newton과 BYOK 간 전환 가능).
키 보안
- BYOK 키나 계정 자격 증명을 Git에 커밋하거 나 스크린샷으로 공유하지 마세요.
- Mystilink는 BYOK 키를 업로드하지 않으며, BYOK 요청은 벤더로 직접 전송됩니다.
- 계정 로그인 토큰을 공유 가능한 "API 키"로 취급하지 마세요.
추가: Newton LLM, LLM providers, Official platform API keys, OpenAI-compatible providers, Local model deployment, FAQ: LLMs & privacy.