Skip to main content
POST
アプリと同じ吹き替え音声カタログ、および保存済みのカスタム吹き替え音声を参照します。再生可能な音声例と音声スロットの利用枠も含まれます。これらの ID は動画吹き替え用です。テキスト読み上げ専用のライブラリは voices_list で取得できます。

認証と権限

string
必須
このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。
必要な権限: voices:read. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

パラメーター

string
テキスト値。許容値: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. デフォルト値: “en”.
string
テキスト値。最小文字数: 2. 最大文字数: 35.
テキスト値。最大文字数: 100.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 条件に一致するカタログの動画吹き替え音声と所有するカスタム音声、および現在の吹き替え音声保存枠。

結果フィールド

操作の注意事項

  • これは動画吹き替え用のライブラリです。別系統の TTS カタログと clone:<UUID> の選択には voices_list を使用してください。
  • locale のデフォルトは en で、en、fr、es、de、it、pt、pl、zh、ja を指定できます。ローカライズされたテキストがない場合は、英語または利用可能な別の翻訳が使用されます。
  • 任意の search は、音声名とローカライズされた説明を対象に、大文字と小文字を区別せず部分一致で検索します。前後の空白を除いて最大100文字です。
  • 省略可能な language は 2–35 文字で、カタログの language または languages メタデータと完全一致で照合されます。カスタム音声を含め、言語メタデータのない音声も引き続き含まれます。
  • 一覧はページ分割されません。カタログボイスとカスタムボイスでは、任意のメタデータが異なります。クローン保存枠の使用数には、保存済みカスタム吹き替えボイスだけを数えます。
  • この例では、所有するカスタム音声1件に絞り込みます。一覧のフィールド名は previewUrl です。クローン作成では、同じ音声サンプルが audioExampleUrl で返されます。
  • 読み上げ履歴とカスタム音声は認証済みアカウントに属します。チームの請求設定によって、他のメンバーの読み上げや音声へのアクセス権が付与されることはありません。

使用量

正常に実行された呼び出しごとに、月間 API/MCP 呼び出し回数を 1 回消費します。メディアクレジットと、その操作固有の生成枠も適用されます。

エラー