맞춤 AI 모델 연결하기: 엔드포인트, API 키, 대체 경로
Mono에서 OpenAI 호환 모델을 설정하고 연결과 대체 경로를 확인하세요. 텍스트 응답과 도구 실행의 차이도 설명합니다.
맞춤 엔드포인트를 쓰면 선택한 서버로 요청을 보낼 수 있습니다. 모델은 내 컴퓨터나 외부 업체 서버에서 실행됩니다. 주소를 입력한다고 휴대폰에서 모델이 실행되는 것은 아닙니다. 문서나 작업 흐름을 연결하기 전에 민감하지 않은 짧은 요청으로 시작하세요.
Reunified의 Mono에서는 내 모델을 쓸 수 있고, 직접 실행하는 모델의 답변에는 Mono에서 비용이 들지 않습니다. Mono는 현재 대기자 명단으로 운영 중입니다. 이 가이드는 설정 화면을 보여 주고, 이용할 수 있게 되면 쓸 체크리스트를 제공합니다. 서버가 호환된다고 해도 실제로 쓸 앱과 모델로 테스트하세요.
1. 올바른 연결 정보를 준비하세요
API 기본 URL, 정확한 모델 ID, 필요하다면 API 키가 있어야 합니다. 서버 운영자의 설정 안내를 따르세요. 웹사이트 주소, 모델 다운로드 페이지, MCP 서버 URL은 모델 API 엔드포인트가 아닙니다.
Mono는 입력한 주소 아래의 Chat Completions 경로로 텍스트 요청을 보냅니다. 그러니 전체 경로가 아니라 API 기본 주소를 입력하세요. 예를 들어 제공업체가 https://models.example.com/v1/chat/completions를 안내한다면 https://models.example.com/v1를 입력합니다. 실제 서비스가 아닌 예시 주소입니다.
모델이 그 밖에 무엇을 지원하는지 확인하세요. 텍스트로 답한다고 해서 이미지, 도구, 스트리밍, 모든 요청 옵션을 지원하는 것은 아닙니다.
2. 한 가지 모델 용도부터 설정하세요
설정을 열고 연동으로 들어가 사용자 지정 엔드포인트의 텍스트 모델을 켭니다. 엔드포인트 URL, API 키, 모델 ID를 각 입력란에 넣으세요. 키를 채팅 메시지나 스크린샷에 넣지 마세요. 로그인이 없는 로컬 서버는 키가 필요 없을 수 있지만, 그렇다고 인터넷에 열어도 안전하다는 뜻은 아닙니다.
텍스트 모델부터 시작하세요. Mono에는 텍스트, 코드, 지원 모델 설정이 따로 있어서 하나를 바꿔도 나머지는 바뀌지 않습니다. 어떤 것을 바꿨는지 적어 두면 나중에 문제가 생겼을 때 어디서부터 볼지 알 수 있습니다.
사용자 지정 텍스트 모델에서는 도구나 스킬 같은 일부 기능이 Mono 기본 내장 모델과 똑같이 동작하지 않을 수 있습니다. 먼저 일반 대화를 테스트하세요. 워크플로에 스킬이 필요하다면, 텍스트 답변이 잘 나온다고 해서 워크플로가 동작한다는 증거는 아닙니다.
3. 실패할 때의 대체 동작을 결정하세요
사용자 지정 모델마다 “연결되지 않으면 기본 모델 사용” 스위치가 있으며, 기본적으로 켜져 있습니다. 서버가 멈췄을 때 모든 기능이 똑같이 반응한다고 가정하지 마세요. 직접 테스트하세요. 서버를 멈추고 사용하는 기능에서 어떤 일이 일어나는지 보세요.
개인정보나 비용 때문에 요청이 내 서버로만 가야 한다면, 이 스위치를 끄고 서버가 실패할 때 어떻게 되는지 테스트하세요. 요청이 실제로 어디로 가는지 확인하세요. 화면의 설정만으로는 충분하지 않습니다. 텍스트 모델을 바꿔도 다른 모델과 연결된 도구는 여전히 확인해야 합니다.
민감한 내용을 보내기 전에 AI 개인정보 안내와 사용량 비용 안내를 읽어보세요.
4. 작은 연결 테스트를 실행하세요
“빨강, 초록, 파랑 세 단어를 한 줄에 하나씩 돌려줘”라고 요청하세요. 답이 오는지, 서버 로그(있다면)에 고른 모델이 나오는지, 제공업체의 사용량 페이지가 테스트와 맞는지 확인합니다.
그다음 실제로 필요한 기능 하나를 테스트하세요. 예를 들면 더 긴 대화입니다. 한 번에 하나만 바꾸세요. 앱 버전, 서버 버전, 모델 ID, 날짜를 기록하세요. 한 조합에서 된다고 모든 모델에서 되는 것은 아닙니다.
서버가 내 컴퓨터에 있다면 휴대폰의 실제 네트워크에서도 테스트하세요. 휴대폰에서 localhost는 휴대폰 자신을 뜻합니다. 보호되지 않은 서비스를 인터넷에 여는 대신, 서버가 지원하는 로그인 방식의 연결을 사용하세요.
5. 가장 먼저 실패한 단계를 찾으세요
| 증상 | 우선 확인할 항목 |
|---|---|
| 연결 시간 초과 | 서버 실행 여부, 기기에서 접근 가능한지, 네트워크 규칙 |
| 인증 거부 | 올바른 키, 계정, 로그인 요구 사항 |
| “찾을 수 없음” 오류 | 기본 URL, /chat/completions 경로를 두 번 붙였는지 |
| 알 수 없는 모델 | 그 서버에서 쓸 수 있는 정확한 모델 ID |
| 텍스트는 되지만 워크플로는 실패 | 워크플로에 필요한 도구나 기타 기능 |
공유하는 로그에서는 비밀 정보를 지우세요. 제공업체 웹사이트에 로그인된다고 API 키가 유효하다는 뜻은 아니며, 텍스트 테스트가 성공했다고 코드 모델이 설정된 것도 아닙니다.
6. 되돌릴 수 있는 설정을 남기세요
이전 설정을 비밀 정보 없이 적어 두세요. 서버를 바꾼 뒤에는 작은 테스트를 다시 하고, 앱과 제공업체 양쪽에서 비용을 확인하세요. 설정을 “로컬”이나 “비공개”라고 부르기 전에 다른 모델 설정도 확인하세요.
Mono 대기자 명단에 등록해 출시 소식을 받아보세요. 모델 교체가 아닌 외부 서비스 연결이 목적이라면 MCP 연결 안내를 사용하세요.
