Azure OpenAI는 어떻게 연결하나요?

위치: 설정 → 콘텐츠 및 게시 → 회원님의 AI 계정

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

시작 전 확인사항

• Azure OpenAI 리소스가 있는 Azure 계정.
• 해당 리소스에 배포(deploy)된 모델이 최소 하나 이상 있어야 합니다. Azure는 모델을 배포한 후에만 실행합니다.
• Azure에서 해당 리소스의 키를 볼 수 있는 권한.
• AI를 관리하는 멤버만 연결할 수 있으며, 최근에 로그인한 상태여야 합니다.

진행 방법

1. Azure portal을 열고 Azure OpenAI 리소스로 이동합니다.
2. 리소스 관리로 이동한 다음 키 및 엔드포인트를 선택합니다.
3. 엔드포인트를 복사합니다. https://my-resource.openai.azure.com 형태이며, 끝자리가 .openai.azure.com 또는 .cognitiveservices.azure.com여야 합니다.
4. KEY 1을 복사합니다. KEY 2는 예비용으로 보관하세요. 관리자 화면에서는 32자리(영문 a–f 및 숫자) 또는 84자리 키를 지원합니다.
5. 배포 이름을 확인합니다. Azure AI Foundry 포털에서 해당 리소스의 배포를 엽니다. 배포 이름은 모델을 배포할 때 직접 지정한 이름입니다. 예를 들어 gpt-4o-mini처럼 모델 자체 이름과 다를 수 있습니다.
6. 사이트 관리자 화면에서 설정 → 콘텐츠 및 발행 → 내 AI 계정을(를) 열고 Azure OpenAI 카드를 찾습니다.
7. Azure 엔드포인트을(를) 붙여넣습니다. 배포 이름 목록 아래에 각 배포를 입력하고, 입력할 때마다 추가을(를) 탭합니다. 최소 하나 이상 추가해야 합니다.
8. 키를 붙여넣고 테스트 및 연결을(를) 탭합니다. "키 확인 중…" 메시지가 표시된 후 연결됨 ✓으로 바뀝니다.

참고 사항

• Azure 리소스는 최대 2개까지 연결할 수 있습니다.
• Azure는 키를 통한 모델 목록 조회를 지원하지 않으므로, 관리자 화면에는 직접 입력한 배포만 표시됩니다. 모델을 추가 배포하면 나중에 언제든 더 등록할 수 있습니다.
• 가격 입력은 선택 사항입니다. 가격을 입력하면 관리자 화면에 예상 비용이 표시됩니다. 가격이 없으면 다른 계정에 오류가 발생해도 이 계정으로 자동 전환되지 않습니다.
• 요금은 Azure에서 청구됩니다. Azure portal에서 비용과 예산을 확인할 수 있습니다. AI 예산 및 한도
• API 키는 회원님의 서버에만 안전하게 보관됩니다. Keynate는 키를 절대 볼 수 없습니다.

자주 발생하는 문제

올바른 Azure OpenAI 엔드포인트를 사용해 주세요

엔드포인트는 반드시 .openai.azure.com 또는 .cognitiveservices.azure.com(으)로 끝나야 합니다. 키 및 엔드포인트 메뉴에서 복사해 오세요. 맞춤 도메인이나 IP 주소는 작동하지 않습니다.

이 모델 또는 배포를 Azure OpenAI 계정에서 찾을 수 없습니다

배포 이름이 일치하지 않습니다. 대소문자를 포함해 정확히 일치해야 합니다. Foundry의 배포 메뉴를 확인하고 카드에서 이름을 수정한 뒤 다시 테스트해 보세요.

Azure OpenAI에서 이 키를 거부했습니다

키 전체를 다시 복사해 보세요. 키는 각 리소스에 종속되어 있으므로, 엔드포인트와 동일한 리소스에서 생성된 키를 사용해야 합니다.

이 주소에 연결할 수 없습니다

엔드포인트에 오타가 없는지 확인해 보세요. 리소스가 특정 네트워크만 허용하도록 제한되어 있으면 테스트에 실패할 수 있습니다. 리소스에 대한 퍼블릭 액세스를 허용하거나, 서버 주소를 허용 목록에 추가한 뒤 다시 시도하세요.

Azure 할당량 또는 호출 한도에 도달했다는 메시지가 뜹니다

1분 정도 기다렸다가 다시 시도하거나, Azure에서 해당 배포의 할당량을 늘려 주세요.

자주 묻는 질문

관련 도움말

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