Skip to main content
POST
音声履歴を新しい順に一覧表示します。過去の生成音声を取得するには、nextCursor を cursor として指定してください。

認証と権限

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

パラメーター

integer
整数値。最小値: 1. 最大値: 100. デフォルト値: 30.
string
tts_generate または tts_list が返す履歴ID。パターン: ^(free-)?[0-9a-f]{64}$.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

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

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 音声生成履歴の概要を新しい順に並べたページと、古い生成履歴を取得するためのカーソル。

結果フィールド

操作の注意事項

  • limit のデフォルトは 30 で、範囲は 1~100 です。次のページには、返された nextCursor を cursor として指定してください。
  • 返された項目数が limit 未満の場合、nextCursor は null です。最後のページが上限件数に達している場合はカーソルが返されることがあり、次の呼び出しが空になる場合があります。
  • 各 textPreview には先頭から最大 180 文字が含まれます。スクリプト全体と音声 URL には tts_get を使用してください。
  • 履歴項目は status: success を返します。音声生成結果の status: completed とは異なります。
  • 読み上げ履歴とカスタム音声は認証済みアカウントに属します。チームの請求設定によって、他のメンバーの読み上げや音声へのアクセス権が付与されることはありません。

使用量

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

エラー