Skip to main content
POST
文字起こし済みの既存プロジェクトで、指定した翻訳先言語の SRT から音声を生成します。音声と任意のリップシンクには通常のメディアクレジットが適用されます。projects_status をポーリングしてください。

​
認証と権限

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

​
パラメーター

​
string
必須
テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/\\]+$.
​
boolean
真偽値。
​
boolean
真偽値。
​
number
数値。最小値: 1. 最大値: 70.
​
string
テキスト値。許容値: “cloning”, “custom”.
​
string
テキスト値。最小文字数: 1. 最大文字数: 128.
​
boolean
真偽値。
​
string
テキスト値。許容値: “translated”, “original”.
​
string
テキスト値。許容値: “studio”, “realistic”.
​
string
テキスト値。許容値: “standard”, “pro”, “studio”.
​
boolean
真偽値。
​
object
JSON オブジェクト。ネストされたフィールドは完全な入力スキーマを参照してください。
​
array
値のリスト。要素の構造は完全な入力スキーマを参照してください。最大要素数: 100.
​
string
必須
テキスト値。許容値: “afrikaans”, “albanian”, “amharic”, “arabic”, “armenian”, “assamese”, “azerbaijani”, “basque”, “belarusian”, “bengali”, “bosnian”, “bulgarian”, “catalan”, “croatian”, “czech”, “danish”, “dutch”, “english”, “british english”, “estonian”, “finnish”, “french”, “french canadian”, “galician”, “german”, “greek”, “gujarati”, “hebrew”, “hindi”, “hungarian”, “icelandic”, “indonesian”, “irish”, “italian”, “japanese”, “kannada”, “kazakh”, “khmer”, “korean”, “lao”, “latvian”, “lithuanian”, “macedonian”, “malay”, “malayalam”, “mandarin”, “marathi”, “mongolian”, “nepali”, “norwegian”, “persian”, “polish”, “portuguese”, “brazilian portuguese”, “pt_brazil”, “punjabi”, “romanian”, “russian”, “serbian”, “slovak”, “slovenian”, “spanish”, “swahili”, “swedish”, “tagalog”, “tamil”, “telugu”, “thai”, “turkish”, “ukrainian”, “urdu”, “vietnamese”, “welsh”, “yoruba”, “zulu”.
​
string
必須
テキスト値。最小文字数: 1. 最大文字数: 1000000.
​
string
トランスポート境界では任意です。省略すると、検証前にサーバーが識別子を補完します。レスポンスを受信できなかった場合に安全に復旧できるよう、固定の UUID v4 を指定してください。形式: “uuid”. パターン: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

​
冪等性

変更操作ごとに、requestId または Idempotency-Key HTTP ヘッダーに UUID v4 を指定してください。ネットワーク障害後の再試行では、同じ識別子と同一の引数を使用します。両方を指定する場合は一致させる必要があります。保存済みリクエストを再取得しても、操作は再実行されず、月間呼び出し回数も追加で消費されません。失敗または中断したリクエストは自動的には再開されません。 すべての変更操作は、再試行時に同じリクエストがまだ実行中であれば、通常の初回実行が同期処理であっても HTTP 202 を返す場合があります。実行が完了していても resultStored が false の場合、再試行では元の結果ではなく、保存済みリクエストの状態を HTTP 200 で返します。出力は対応するドメインの履歴、結果、またはダウンロードアクションで取得してください。

​
リクエスト例

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

​
レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 呼び出し元が指定した翻訳先言語の SRT による音声生成を受け付けた後、プロジェクト ID と言語別作業 ID を返します。

​
結果フィールド

​
リクエストの復旧とポーリング

接続が切断された後も同じ識別子を使用してください。resultStored が false の場合は、対応する履歴、結果、またはダウンロードアクションで出力を取得します。進捗を確認するためだけに、別の生成を開始しないでください。
HTTP 200

​
操作の注意事項

  • translatedSrt は必須で、有効なSRTキューを含む必要があります。このアクションには、完了済みの元の文字起こしが必要です。キューは開始時刻の差が0.05秒以内の既存原文セグメントに対応付け、一致しない場合は時間の重なりが最大のものを使用します。出力タイミングには常に原文セグメントのタイムラインを使用します。
  • 翻訳先言語のワークを再利用または作成します。指定したテキストを、自動翻訳や SmartSync を行わずに吹き替えます。
  • ソースメディアは再アップロードしません。長さと音声・動画の種類は、保存済みプロジェクトから取得します。
  • このアクションは sourceSrt、fileKey、メディア URL、webhookUrl を受け取りません。
  • voiceMode の既定値は cloning です。voiceMode custom では、カタログの音声、または認証済みアカウントが保存したカスタム音声を使用し、voiceCloningSettings は指定しないでください。チームでの請求によって他のメンバーの保存済み音声にアクセスできるようにはなりません。
  • 任意の subtitles、lipSyncMode、translationTimeSkips には動画入力が必要です。スキップ範囲はメディアの長さの範囲内で、keepBackgroundMusic は true、keepOriginalVoice は false である必要があります。
  • lipSyncMode は standard、pro、studio を受け付け、プランと通常のメディアクレジット確認が適用されます。月間 API 呼び出しが無制限でも、音声生成やリップシンクが無料になるわけではありません。
  • メディア処理の状態は projects_status をポーリングし、全言語のバージョンは projects_get で取得してください。
  • 対応する原文セグメントがない字幕キュー、またはテキストが指定されていない原文セグメントがあると、バックグラウンドパイプラインが失敗する場合があります。受付後に projects_status.error または projects_get の translations を確認してください。

​
使用量

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

​
エラー