ボイスデザイン

合成するテキストと声のスタイルの説明に基づいて、そのスタイルのボイスまたは音声プレビューを生成します。

1. APIキーを作成

   APIキー管理プラットフォームにアクセスしてAPIキーを作成し、環境変数として保存してください。APIキーをクライアントコードに書き込んだり、リポジトリにコミットしたりしないでください。

   MOSS_API_KEY=<your_api_key_here>

2. リクエスト入力を準備

   このシナリオに合わせてリクエストパラメータを準備します。同期呼び出しでは結果を直接待つことができます。時間のかかる処理ではasync=trueとwebhook_urlを渡せます。

   フィールド型必須説明

   model: string必須

   moss-voice-generator-1.0

   input: string必須

   音声を生成するテキスト

   instruction: string必須

   声のスタイルの説明

   delivery_method: string任意

   urlはJSONと結果URLを返します

   response_format: string任意

   同期リクエストの音声形式。mp3を推奨

   {
     "model": "moss-voice-generator-1.0",
     "input": "今夜の番組へようこそ。",
     "instruction": "やさしく自然で、ほのかに微笑みを感じさせる若い女性の声",
     "delivery_method": "url",
     "response_format": "mp3"
   }

3. 最初のリクエストを送信

   このシナリオのエンドポイントにリクエストを送信します。同期リクエストでは音声バイナリが直接返されるか、delivery_method=urlの場合は結果URLを含むJSONが返されます。async=trueの場合はタスクオブジェクトが返されます。

   curl https://api.mosi.cn/v1/audio/voice/generations \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "model": "moss-voice-generator-1.0",
     "input": "今夜の番組へようこそ。",
     "instruction": "やさしく自然で、ほのかに微笑みを感じさせる若い女性の声",
     "delivery_method": "url",
     "response_format": "mp3"
   }'

   import os
   import requests
   
   resp = requests.post(
       "https://api.mosi.cn/v1/audio/voice/generations",
       headers={
           "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
           "Content-Type": "application/json",
       },
       json={
           "model": "moss-voice-generator-1.0",
           "input": "今夜の番組へようこそ。",
           "instruction": "やさしく自然で、ほのかに微笑みを感じさせる若い女性の声",
           "delivery_method": "url",
           "response_format": "mp3"
       },
   )
   
   print(resp.status_code)
   print(resp.json())

   const response = await fetch("https://api.mosi.cn/v1/audio/voice/generations", {
     method: "POST",
     headers: {
       Authorization: `Bearer ${process.env.MOSS_API_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
     "model": "moss-voice-generator-1.0",
     "input": "今夜の番組へようこそ。",
     "instruction": "やさしく自然で、ほのかに微笑みを感じさせる若い女性の声",
     "delivery_method": "url",
     "response_format": "mp3"
   }),
   });
   
   console.log(response.status);
   console.log(await response.json());

4. タスクの結果を取得

   delivery_method=urlで同期呼び出しを行った場合は、レスポンスJSONからボイス生成結果のURLを読み取ります。async=trueを渡すとtask_idが返されるので、GET /v1/audio/tasks/{task_id}でタスク結果を照会できます。最終的な音声形式はタスク結果に準じます。

   curl https://api.mosi.cn/v1/audio/tasks/$TASK_ID \
     -H "Authorization: Bearer $MOSS_API_KEY"

5. 成功を確認

   成功の目安：説明したスタイルで生成された音声または結果URLを取得でき、ダウンロードまたは再生できます。

次のステップ