사용자 지정 AI 주소는 어떻게 연결하나요?

위치: 설정 → 콘텐츠 및 게시 → 내 AI 계정

이 페이지 열기: admin.<your-site>/settings/ai/providers (<your-site> 부분을 사이트 주소로 변경)

시작 전 확인사항

• 최근에 로그인한 사이트 소유자여야 합니다.
• 서비스가 https://llm.example.com/v1처럼 보통 /v1(으)로 끝나는 OpenAI 호환 주소를 제공해야 합니다.
• 서비스가 도구(함수 호출)를 지원해야 합니다. 지원하지 않는 모델은 사이트를 수정할 수 없습니다.
• 신뢰할 수 있는 서비스여야 합니다. Keynate는 해당 서비스가 회원님의 콘텐츠를 어떻게 처리하는지 확인할 수 없습니다.

진행 방법

1. 해당 서비스 페이지에서 주소를 확인하고, 필요한 경우 키도 함께 발급받습니다.
2. 사이트 관리자 화면에서 설정 → 콘텐츠 및 발행 → 내 AI 계정 페이지를 열고 Custom (OpenAI-compatible) 카드를 찾습니다.
3. 모델 메뉴에 표시될 이름을(를) 입력합니다.
4. 기본 URL을(를) 입력합니다.
5. 키를 붙여넣습니다. 키가 필요 없는 서비스라면 비워두셔도 됩니다.
6. 해당 주소에서 모델 목록을 자동으로 불러오지 못하면 모델 ID 목록을(를) 직접 입력하고 각각 추가을(를) 누릅니다.
7. "프롬프트, 사이트 콘텐츠, 도구 실행 결과가 이 주소로 전송됩니다." 확인란을 선택합니다.
8. 선택 사항으로 입력 및 출력에 대한 1M 토큰당 가격을 입력합니다. 가격을 입력하면 관리자 화면에 비용이 표시되며 다른 계정에 문제가 생겼을 때 대체 계정으로 사용할 수 있습니다.
9. 테스트 및 연결을(를) 누릅니다. "키 확인 중…" 메시지가 나타난 후 연결됨 ✓ 상태로 바뀝니다.

주소 필수 조건

• https://(으)로 시작해야 합니다. 보안이 적용되지 않은 http://은(는) 사용할 수 없습니다.
• 표준 보안 포트를 사용해야 합니다. 다른 포트는 허용되지 않습니다.
• 숫자 주소(IP)가 아닌 llm.example.com와(과) 같은 도메인 이름이어야 합니다.
• 인터넷에서 접속 가능한 공개 주소여야 합니다. 사설 네트워크나 개인 컴퓨터의 주소는 사용할 수 없습니다.
• 사용자 이름, ?query, #part이(가) 포함되어서는 안 됩니다.
• Keynate 주소는 사용할 수 없습니다.

참고 사항

• 사용자 지정 주소는 최대 3개까지 연결할 수 있습니다.
• 키는 지정된 해당 주소로만 전송됩니다. 주소를 변경하면 키를 다시 입력해야 합니다.
• 가격을 입력하지 않으면 다른 계정에 장애가 발생해도 AI가 이 계정으로 자동 전환되지 않습니다.
• 키는 회원님의 자체 서버에만 보관됩니다. Keynate는 이를 절대 보거나 수집하지 않습니다.
• 소유자만 사용자 지정 주소를 추가하거나 수정할 수 있으며, 변경한 사람과 일시가 기록됩니다.

자주 발생하는 문제

올바른 주소가 아닙니다

https://llm.example.com/v1 형식이어야 합니다. 공백이나 경로 뒤에 붙은 불필요한 문자를 모두 지워주세요.

주소는 https://로 시작해야 합니다

보안 주소를 사용하세요. 서비스가 http://만 지원한다면 먼저 https 보안 설정을 적용해야 합니다.

IP 주소가 아닌 llm.example.com과 같은 이름을 사용하세요

숫자로 된 주소 대신 서비스의 도메인 이름을 입력하세요.

사설 네트워크를 가리키는 주소입니다

공개 주소를 사용하세요. 사설 네트워크에 있는 서비스는 회원님의 서버에서 연결할 수 없습니다.

해당 주소에 연결할 수 없습니다

오타가 없는지 확인하고, 서비스가 정상 실행 중이며 외부 인터넷에 열려 있는지 확인하세요.

이 주소를 연결하려면 먼저 동의 확인란을 선택하세요

확인란을 선택하세요. 회원님의 콘텐츠가 해당 주소로 전송되는 사실을 인지했음을 확인하는 절차입니다.

이 계정에는 사이트를 수정할 수 있는 모델이 없습니다

도구(함수 호출)를 지원하는 모델 ID를 추가하거나 다른 계정을 사용하세요.

서비스의 응답을 처리할 수 없습니다

해당 서비스가 OpenAI 형식을 완벽하게 지원하지 않을 수 있습니다. 서비스 설명서를 확인하여 올바른 기본 URL(Base URL)을 입력했는지 점검하세요.

자주 묻는 질문

관련 도움말

• 내 키로 AI 연동하기
• AI 예산 및 사용 한도
• AI 작동 안 됨