OpenMAIC 설정 가이드
AI 교사, 급우 및 코스 내레이션을 위해 OpenMAIC에서 Kitta AI를 사용자 정의 OpenAI 호환 TTS 공급자로 추가합니다.
Kitta AI TTS를 OpenMAIC에 연결합니다.
OpenMAIC은 사용자 정의 OpenAI 호환 TTS 공급자를 지원합니다. Kitta AI를 연결하면 AI 교사, 급우, 강좌 내레이션, 생성된 콘텐츠가 선택한 음성을 사용할 수 있습니다.
API 키와 음성 ID를 준비하세요
- API 관리에서 전용키를 생성합니다.
- 복제된 음성을 열고 음성 ID를 복사하세요.
- API 크레딧 잔액이 충분한지 확인하세요.
빠른 테스트를 위해 다음을 사용하세요.
00a1b221-6137-4b73-ad62-b0cbce134167설정에서 맞춤 공급자 추가
Settings → TTS를 열고 사용자 정의 OpenAI 호환 TTS 공급자를 추가합니다. 입력하다:
| OpenMAIC 설정 | 가치 |
|---|---|
| 제공자 이름 | Kitta AI |
| 기본 URL | https://kittaai.com/v1 |
| API 키 | 귀하의 Kitta AI API 키 |
| 모델 | fishaudio-s21pro-flash |
| 음성 ID | 복제된 음성의 음성 ID |
| 음성 이름 | 모든 표시 이름 |
OpenMAIC은 기본 URL에 /audio/speech를 추가하고 최종 요청을 POST /v1/audio/speech로 보냅니다. 기본 URL 필드에 전체 엔드포인트를 입력하지 마십시오.
음성을 추가한 후 이를 활성 TTS 공급자로 만들고 새 음성 ID를 선택합니다. 짧은 문장으로 TTS 테스트 버튼을 사용하여 음성 및 인증을 확인하세요.
Prefer server-side keys for shared deployments
OpenMAIC은 클라이언트 설정에 사용자 정의 공급자를 저장할 수 있습니다. 신뢰할 수 있는 네트워크에만 API 키를 입력하세요. 자체 호스팅 인스턴스. 공용 또는 다중 사용자 배포의 경우 관리자는 TTS를 구성해야 합니다. 서버 측이므로 키가 브라우저 사용자에게 노출되지 않습니다.
서버 측 구성
자체 호스팅 관리자는 OpenMAIC 환경 변수를 사용하여 Kitta AI를 구성할 수 있습니다.
TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://kittaai.com/v1환경을 변경한 후 OpenMAIC을 다시 시작하십시오. 그런 다음 TTS 설정에서 OpenAI 공급자를 선택하고 모델과 음성을 Kitta AI 모델 ID 및 음성 ID로 바꿉니다.
문제 해결
- 404: 기본 URL은
/v1에서 중지되어야 합니다. 경로가 중복될 수 있으므로/v1/audio/speech를 입력하지 마십시오. - 401: 활성 공급자의 API 키를 확인합니다. 서버 측 키를 변경한 후 OpenMAIC을 다시 시작하십시오.
- 402: 다시 시도하기 전에 API 크레딧을 추가하세요.
- 400:
fishaudio-s21pro-flash를 모델로 사용하고 유효한 Voice ID를 사용합니다. - 테스트는 작동하지만 교실은 조용합니다: Kitta AI를 활성 공급자로 만들고 해당 음성을 내레이션 역할에 할당합니다.
- 브라우저 CORS 또는 주요 문제: 공유 배포에서 OpenMAIC의 서버측 TTS 구성을 사용합니다.