Skip to main content
POST
利用可能な読み上げ音声、保存済みのカスタム音声、再生可能な有効期限内のプレビュー、音声作成の利用枠を一覧表示します。

認証と権限

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

パラメーター

空の JSON オブジェクトを送信してください。このアクションに入力フィールドはありません。
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

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

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 利用可能な TTS カタログ音声と所有する保存済みカスタム音声、保存スロットの利用枠、有効な未保存プレビュー、音声作成の利用枠。

結果フィールド

操作の注意事項

  • カタログの例は省略されています。アクションは利用可能な TTS ライブラリを返し、カタログ項目の前に保存済みカスタムボイスを並べます。
  • tts_generate では voices[].id を使用してください。保存済み音声は clone:<UUID> を使用し、カタログ ID は不透明です。これらの ID は dubbing_voices_list とは別系統です。
  • カタログ項目には accent、gender、style、previewFileName が含まれ、previewUrl は省略可能です。保存済みカスタム項目には accent: original、source: clone、一時的な previewUrl が含まれます。
  • canClone はプランがカスタム TTS 音声の保存に対応しているか、remaining は空きスロット数を示します。予約済みの作成が used に計上される場合があります。
  • voicePreviews に含まれるのは、所有する未保存の ready 状態で、有効期限内の候補のみです。プレビューの有効期間は24時間ですが、再生用URLはそれより早く期限切れになる場合があります。
  • cloneTrial は、生涯で1回のクローンプレビュー利用枠です。有料プランではUTC日ごとに5回のデザインリクエストが可能で、成功するたびに2つの候補を作成します。creationUsage は現在の利用枠とリセット時刻を示します。
  • 読み上げ履歴とカスタム音声は認証済みアカウントに属します。チームの請求設定によって、他のメンバーの読み上げや音声へのアクセス権が付与されることはありません。

使用量

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

エラー