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