AI 제공업체 키
텍스트 및 음성 제공업체의 BYOK 자격 증명을 설정합니다.
텍스트 및 음성 제공업체의 BYOK 자격 증명을 설정합니다.
BYOK(Bring Your Own Key)를 사용하면 지원되는 AI 요청이 자신의 AI 제공업체 계정을 사용합니다. 새 키를 저장하려면 Scale이 필요합니다. Launch와 Operate에서도 이미 저장된 키는 계속 동작합니다. Make Agent Fast 요금제와 호출당 정액 플랫폼 수수료는 그대로 내며, 모델 사용료는 제공업체가 사용자에게 직접 청구합니다.
지원 제공업체#
| 제공업체 | 사용 용도 | 키 만들기 또는 확인 |
|---|---|---|
| Anthropic | 에이전트 텍스트 생성 | Anthropic API 문서 |
| OpenAI | 에이전트 텍스트 생성 및 설정된 음성 모드 | OpenAI API 빠른 시작 |
| Google Gemini | 에이전트 텍스트 생성 및 설정된 실시간 모드 | Gemini API 키 |
| Deepgram | Deepgram이 STT 제공업체일 때 음성 인식 | Deepgram API 키 |
| ElevenLabs | ElevenLabs가 설정된 경우 음성 합성 및 복제 | ElevenLabs 인증 |
제공업체 사용 가능 여부는 플랫폼에 설정된 텍스트, 음성 인식, 실시간, 복제 제공업체에도 달려 있습니다. 유효한 키를 저장해도 모든 기능이 그 제공업체를 강제로 사용하는 것은 아닙니다.
제공업체 키 추가#
- 제공업체 콘솔에서 제한된 키를 만들고 필요하면 제공업체 결제 또는 할당량을 활성화합니다.
- 대시보드 → 설정 → AI 제공업체 키를 엽니다.
- 일치하는 제공업체를 선택하고 프로젝트 또는 환경을 식별할 레이블을 추가합니다.
- 키를 붙여 넣고 저장합니다.
- 검증 결과를 기다린 뒤 그 제공업체를 사용하는 기능을 테스트합니다.
Make Agent Fast는 키를 활성 상태로 표시하기 전에 실제 검증 요청을 보냅니다. 키에는 공백이나 줄바꿈이 없어야 하며 길이는 16~512자여야 합니다. Anthropic 키는 sk-ant-, OpenAI 키는 sk-로 시작해야 합니다. 다른 제공업체는 안정적인 공개 접두사가 없으므로 실제 검증 결과가 기준입니다.
같은 제공업체의 다른 키를 저장하면 이전 저장 값을 대체합니다. 대시보드는 레이블, 마지막 네 글자, 검증 시각, 상태 같은 안전한 식별 정보만 유지합니다.
텍스트 제공업체 선택 방식#
텍스트 생성 시 Make Agent Fast는 먼저 플랫폼에 설정된 텍스트 제공업체와 일치하는 활성 BYOK 키를 찾습니다. 없으면 활성 Anthropic, OpenAI, Gemini 키를 순서대로 확인합니다. 적합한 BYOK 키가 없으면 요금제와 배포 설정이 허용하는 경우 플랫폼 제공업체를 사용합니다.
음성 키는 제공업체별로 사용됩니다. 활성 음성 인식 제공업체가 Deepgram일 때만 Deepgram 키를 사용하고, 음성 합성 또는 복제가 ElevenLabs로 설정되었을 때만 ElevenLabs 키를 사용합니다.
BYOK 키는 현재 플랫폼의 지식 임베딩 자격 증명을 대체하지 않습니다. 지식 수집과 검색은 배포에 설정된 임베딩 제공업체를 계속 사용합니다.
결제 및 크레딧#
- 외부 제공업체는 키를 발급한 계정에 사용료를 청구합니다.
- Make Agent Fast는 지원되는 BYOK 작업의 구독료와 인프라 부분을 계속 청구합니다.
- 텍스트 BYOK 요청은 일반적으로 전체 모델 비용 미터 대신 낮은 인프라 미터를 사용합니다.
- 음성 작업은 캡처, 인식, 합성, 전달, 오케스트레이션이 분리되어 있어 음성 파이프라인 최소 비용이 유지될 수 있습니다.
- 제공업체 할당량이 소진되면 Make Agent Fast 크레딧이 남아 있어도 요청이 실패할 수 있습니다.
Make Agent Fast의 사용량 및 크레딧과 제공업체의 사용량 대시보드를 함께 확인하세요.
키 상태 및 오류 처리#
| 상태 | 의미 | 해야 할 일 |
|---|---|---|
active | 실제 검증 성공 | 대상 기능을 테스트하고 제공업체 사용량 모니터링 |
invalid | 검증 실패 또는 이후 제공업체가 거부 | 제공업체 결제, 제한, 할당량, 폐기 상태를 확인하고 대체 키 저장 |
revoked | Make Agent Fast에서 키 비활성화 | 기능이 BYOK를 계속 사용해야 한다면 대체 키 생성 또는 활성화 |
제공업체가 자격 증명이나 할당량을 거부해 요청이 실패하면 Make Agent Fast가 저장된 키를 잘못된 상태로 표시할 수 있습니다. 제공업체에서 키를 수정해도 저장된 시크릿이 공개되거나 자동 변경되지 않습니다. 작동하는 키를 다시 저장해 재검증하세요.
제공업체 키 교체#
- 이전 키를 삭제하지 않은 상태에서 새 제공업체 키를 만듭니다.
- 새 키를 Make Agent Fast에 저장하고 활성 상태가 되는지 확인합니다.
- 텍스트 채팅, 음성 메시지 또는 복제 중 해당 제공업체를 사용하는 기능을 테스트합니다.
- 제공업체 콘솔에서 이전 키를 폐기합니다.
- 제공업체 로그에서 이전 키의 예상치 못한 사용을 확인합니다.
키가 소스 제어나 브라우저 코드에 노출되었다면 제공업체에서 즉시 폐기하세요. Make Agent Fast에서만 삭제해도 다른 보유자가 제공업체에 직접 사용하는 것을 막을 수 없습니다.