OpenMAIC セットアップガイド
AI 教師、クラスメート、コースのナレーション用に、OpenMAIC に OpenAI 互換のカスタム TTS プロバイダーとして Kitta AI を追加します。
Kitta AI TTS を OpenMAIC に接続します
OpenMAIC は、カスタム OpenAI 互換の TTS プロバイダーをサポートします。 Kitta AI を接続すると、AI 教師、クラスメート、コースのナレーション、生成されたコンテンツで選択した音声を使用できるようになります。
API キーと Voice 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 | クローンされた音声の Voice 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: モデルと有効な音声 ID として
fishaudio-s21pro-flashを使用します。 - テストは機能しますが、教室は沈黙しています: Kitta AI をアクティブなプロバイダーにし、その音声をナレーションの役割に割り当てます。
- ブラウザ CORS または主な懸念事項: 共有展開で OpenMAIC のサーバー側 TTS 構成を使用します。