공식 플랫폼 API Key 구성
BYOK는 자신의 사업자 계정과 API Key로 모델을 연결하는 것을 뜻합니다. 키는 Mystilink 로컬에 구성되고 모델 사용량은 해당 사업자가 과금합니다. Mystilink 계정과 잔액을 쓰고 싶다면 Newton LLM을 참고하고, 여기서 서드파티 Key를 추가할 필요가 없습니다.
먼저 세 가지 정보 준비
- API Key: 실제로 API를 제공하는 사업자의 오픈 플랫폼에서 생성합니다. 웹 로그인 비밀번호, Mystilink 활성화 키, 채팅 제품의 로그인 자격 증명을 넣지 마세요.
- 모델 ID: 현재 API 계정이 사용 권한을 가진 식별자여야 합니다. 표시 이름이 요청에 쓰는 ID와 같지 않을 수 있습니다.
- API 권한과 한도: 사업자의 채팅 웹에 로그인할 수 있다고 해서 그 계정에 사용 가능한 API 한도가 있는 것은 아닙니다. 오픈 플랫폼에서 확인하세요.
인터넷 예시의 오래된 모델 이름을 반드시 사용 가능하다고 여기지 마세요. 현재 사용 가능한 모델 목록에서 고르고, 직접 입력할 때는 글자 하나하나 확인하세요.
Mystilink에서 추가
설정 → 대형 모델을 열고 서비스에 해당하는 사업자를 선택합니다. API Key를 입력하거나 화면이 지원하는 방식으로 로컬에서 읽을 수 있는 환경 변수 이름을 입력합니다. 공식 서비스를 사용할 때는 템플릿 기본 주소를 유지하고, 프록시나 다른 엔드포인트가 명확히 필요할 때만 Base URL을 덮어쓰세요.
먼저 연결을 테스트한 뒤 모델 ID를 입력하거나 선택하고 표시 이름을 보충해 저장합니다. 대상 구성을 주 모델로 설정한 뒤 개인 정보가 없는 메시지로 대화가 완료되는지 확인하세요. 연결 테스트 성공이 모델의 완전한 Agent 도구 호출 능력을 보장하지는 않습니다.
사업자와 프로토콜
다음은 Mystilink의 해당 템플릿과 공식 진입점이며, 사용 가능 지역, 모델, 가격을 약속하는 것은 아닙니다. 구체적인 Key 발급 절차, 권한, 요금 규칙은 사업자 플랫폼을 기준으로 합니다.
| 사업자 | 공식 진입점 | Mystilink 템플릿 주의 사항 |
|---|---|---|
| OpenAI | API 플랫폼, 인증 안내 | OpenAI 템플릿 사용. 기본 주소를 유지하고 계정이 실제로 쓸 수 있는 모델 선택 |
| Anthropic | Console, API 문서 | 네이티브 API는 Anthropic 프로토콜을 사용하므로 범용 호환 게이트웨이처럼 입력하지 마세요 |
| Google Gemini | AI Studio, 모델 문서 | Gemini 템플릿 사용. 현재 템플릿은 Base URL 덮어쓰기를 제공하지 않음 |
| DeepSeek | 오픈 플랫폼, API 문서 | DeepSeek 템플릿 사용. 모델과 계정 권한 확인 |
| MiniMax | 오픈 플랫폼 | 해당 템플릿 사용. 지역별 계정, 키, 주소를 섞지 마세요 |
| Moonshot / Kimi | 오픈 플랫폼 | 해당 템플릿 사용. 모델 ID와 주소는 같은 서비스 지역과 계정에서 가져와야 합니다 |
Anthropic
공식 네이티브 서비스를 사용할 때는 Anthropic 템플릿을 선택합니다. 사업자가 별도의 호환 게이트웨이를 제공한다면 그쪽이 공개한 호환 프로토콜과 주소를 사용해야 하며, 모델 이름에 Claude가 들어 있다는 이유만으로 네이티브 템플릿을 고르면 안 됩니다.
Google Gemini
Gemini 템플릿으로 공식 네이티브 API에 연결합니다. 서드파티 플랫폼이 제공하는 Gemini 모델은 다른 호환 프로토콜을 쓸 수 있으므로 실제 게이트웨이에 따라 사용자 정의 사업자를 선택하세요.
주소, 키, 모델은 같은 서비스에서 와야
공식 Key를 프록시에 쓰는 것이 항상 가능하지는 않고, 프록시 Key도 공식 주소에 바로 쓸 수 없습니다. 확인할 때는 누가 Key를 발급했는지, 요청이 어느 도메인으로 가는지, 그 계정이 어떤 모델을 쓸 수 있는지를 함께 봐야 합니다. 주소를 덮어쓰면 요청 내용이 새 주소의 서비스로 전송됩니다.
Base URL에는 서비스의 API 접두사를 입력하고, 전체 채팅 요청 경로나 모델 상세 웹페이지를 붙여넣지 마세요. 서드파티 게이트웨이나 로컬 서비스 구성은 호환 사업자와 로컬 모델을 참고하세요.
자주 발생하는 문제
| 증상 | 먼저 확인 |
|---|---|
| 401 / Key 무효 | Key가 현재 주소의 것인지, 만료되었거나 취소되었는지, 환경 변수를 앱이 읽을 수 있는지 |
| 모델 목록이 비어 있음 | 계정 권한, 모델 검색 지원 여부. 정확한 ID를 알면 직접 입력 가능 |
| 404 / model not found | API 접두사와 모델 ID. 표시 이름을 ID로 쓴 것은 아닌지 |
| 테스트는 성공하지만 작업이 완료되지 않음 | 도구 호출, 스트리밍, 모델 능력. 네트워크만 확인하지 말 것 |
| 한도 관련 오류 | 실제 사업자에서 API 청구를 확인. Newton 충전은 서드파티 한도를 보충하지 않음 |
더 많은 확인은 대형 모델 연결 문제를 참고하세요. Key가 유출되면 발급 플랫폼에서 취소하고 다시 구성해야 하며, 표시 이름만 바꾸거나 스크린샷을 지우는 것으로는 부족합니다.