すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitAudioProduceJob

    ドキュメントセンター

    Intelligent Media Services:SubmitAudioProduceJob

    最終更新日:Apr 07, 2026

    この API は、テキストを高品質の音声ファイルに変換します。

    操作説明

    これは非同期 API です。ジョブを送信すると、ジョブ ID が返され、ジョブはバックグラウンドで処理されます。結果は、コールバック通知、または GetSmartJobResult API を使用したジョブステータスのクエリによって取得できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ice:SubmitAudioProduceJob

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    EditingConfig

    string

    必須

    オーディオ生成設定：

    • voice：音声タイプ。

    • customizedVoice：音声クローニング用のカスタム音声の ID。

    • format：出力ファイル形式。サポートされているフォーマット：PCM、WAV、MP3。

    • volume：ボリューム。値の範囲は 0～100 です。デフォルト値：50。

    • speech_rate：話速。値の範囲は -500～500 です。デフォルト値：0。

      • -500、0、500 の値は、それぞれ 0.5 倍速、1.0 倍速、2.0 倍速に対応します。

      • 計算方法：

        • 0.8 倍速の場合：(1 - 1/0.8) / 0.002 = -125。

        • 1.2 倍速の場合：(1 - 1/1.2) / 0.001 = 166。

        • 1 未満の倍速の場合は、係数 0.002 を使用します。

        • 1 を超える倍速の場合は、係数 0.001 を使用します。

    • pitch_rate：ピッチレート。値の範囲は -500～500 です。デフォルト値：0。
      重要 voice と customizedVoice の両方を指定した場合、customizedVoice が優先されます。

    {"voice":"Siqi","format":"MP3","volume":50}
    OutputConfig

    string

    必須

    オーディオ出力設定。

    例如将输出的语音存至：http://my_bucket.oss-cn-shanghai.aliyuncs.com/target_audio.mp3，则此参数配置为： { "bucket": "my_bucket", "object": "target_audio" }
    InputConfig

    string

    必須

    合成するテキスト。最大長は 10,000 文字です。SSML をサポートしています。

    测试文本
    Title

    string

    任意

    ジョブのタイトル。タイトルを指定しない場合、システムは現在の日付に基づいてタイトルを自動的に生成します。

    • 128 バイトを超えることはできません。

    • UTF-8 エンコードである必要があります。

    任务标题。 若不提供，根据日期自动生成默认title 长度不超过128字节 UTF8编码
    Description

    string

    任意

    ジョブの説明。

    • 1,024 バイトを超えることはできません。

    • UTF-8 エンコードである必要があります。

    任务描述长度不超过1024字节 UTF8编码
    UserData

    string

    任意

    JSON 形式のカスタム設定。最大長は 512 バイトです。このパラメーターは、カスタムコールバックアドレスの設定をサポートしています。

    {"NotifyAddress":"http://xx.xx.xxx"}或{"NotifyAddress":"https://xx.xx.xxx"}或{"NotifyAddress":"ice-callback-demo"}
    Overwrite

    boolean

    任意

    既存の OSS ファイルを上書きするかどうかを指定します。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスボディ。

    RequestId

    string

    リクエスト ID。

    ******11-DB8D-4A9A-875B-275798******
    JobId

    string

    ジョブ ID。

    ****20b48fb04483915d4f2cd8ac****
    State

    string

    ジョブのステータス。

    • Created

    • Executing

    • Finished

    • Failed

    Created
    MediaId

    string

    メディア ID。

    ****2bcbfcfa30fccb36f72dca22****

    ジョブ ID と GetSmartJobResult API を使用して、音声合成ジョブの詳細情報をクエリします。次の例は、成功したジョブに対する GetSmartJobResult API からのレスポンス例を示しています。

    説明

    デフォルトでは、TTS エンジンはコンマやピリオドなどの句読点に基づいてテキストをセグメント化します。

    {
  "RequestId": "******2D-443C-5043-B0E4-867070******",
  "JobId": "******042d5e4db6866f6289d1******",
  "State": "Finished",
  "SmartJobInfo": {
    "Title": "default_title_2022-01-21T06:15:07Z",
    "JobType": "TextToSpeech",
    "CreateTime": "2022-01-21T06:15:07Z",
    "ModifiedTime": "2022-01-21T06:15:07Z",
    "InputConfig": {
      "InputFile": "郭徳綱といえば、彼は今、絶大な人気を誇っています。チケットは高価なことが多いですが、すぐに完売してしまいます。彼はまた、様々な漫才バラエティ番組に出演し、新しい演者についてコメントしています。"
    },
    "EditingConfig": "{\"format\":\"MP3\",\"pitch_rate\":0,\"sample_rate\":16000,\"speech_rate\":0,\"voice\":\"Siqi\",\"volume\":50}",
    "OutputConfig": {
      "Bucket": "your-bucket",
      "Object": "your-audio"
    }
  },
  "JobResult": {
    "MediaId": "******bf47c94e82b3b2014361******",
    "AiResult": "[{\"text\":\"郭徳綱といえば、\",\"begin_time\":0,\"end_time\":846},{\"text\":\"彼は今、絶大な人気を誇っています。\",\"begin_time\":846,\"end_time\":3386},{\"text\":\"チケットは高価なことが多いですが\",\"begin_time\":3386,\"end_time\":4402},{\"text\":\"すぐに完売してしまいます。\",\"begin_time\":4402,\"end_time\":6265},{\"text\":\"彼はまた、様々な漫才バラエティ番組に出演し、新しい演者についてコメントしています。\",\"begin_time\":6265,\"end_time\":10330}]"
  }
}

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "State": "Created",
  "MediaId": "****2bcbfcfa30fccb36f72dca22****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。