Skip to main content
翻訳ステータスの取得

翻訳ステータスの取得

翻訳プロジェクトの現在のステータスを取得します。このエンドポイントを使用して進捗状況をポーリングし、処理完了時に翻訳済み動画のURLを取得します。

リクエスト

ヘッダー

string
必須
VoiceCheap APIキー。app.voicecheap.ai/page-apiから取得してください。

パスパラメータ

string
必須
Start Translationエンドポイントから返される翻訳プロジェクトの一意の識別子。

レスポンス

レスポンス構造は翻訳ステータスによって異なります。

共通フィールド

string
必須
プロジェクトの一意の識別子
string
必須
プロジェクト名
string
必須
アップロードされた元の動画/音声ファイルのURL
string
必須
検出または指定された元の言語
string
必須
翻訳先の言語
number
必須
コンテンツの長さ(秒単位)
number
必須
プロジェクトが作成されたUnixタイムスタンプ
string
必須
プロジェクトを作成したAPIワークフロー:translationまたはtranscription
string
必須
ソース文字起こしステータス:processingsuccess、またはfailed。このシグナルは吹き替えの完了とは独立しています。
object
必須
利用可能な正規化された文字起こし。
string
現在報告されている翻訳バージョンの翻訳作業識別子。
string
現在報告されている翻訳バージョンの翻訳済みバージョン識別子。
string
現在のプロジェクトステップ。作成中または文字起こし中は、アクティブな作成ステップを反映します。 例として、downloading_contentcontent_validationtranscription_processingなどがあります。 吹き替えが開始されると、smart_syncaudio_assemblingなどのアクティブな吹き替えステップに切り替わることがあります。 status: processingactualProgressStep: doneとペアになりません。
number
プロジェクト作成/文字起こしの概算進捗率(0-100)
string
翻訳先言語の現在の吹き替えステップ(例:smart_syncaudio_enhancementvideo_upload
number
吹き替えの概算進捗率(0-100)
string
必須
翻訳の現在のステータス:processingsuccess、またはfailed

Lip Syncフィールド

リップシンクがリクエストされた場合、レスポンスには追加のlipSyncオブジェクトが含まれます:
object
リップシンクのステータスと出力詳細(リップシンクがリクエストされた場合にのみ存在)
リップシンクがリクエストされると、翻訳はlipSync.statusCOMPLETEDになるまでprocessingの状態を維持します。リップシンクが失敗した場合、ステータスは failedとなり、error.codeLIPSYNC_FAILEDとなります。リップシンクが成功した場合は、lipSync.videoUrlからリップシンク済みのアセットを読み取ってください。translatedVideoUrl は、リップシンクオーバーレイ適用前の翻訳済みビデオ出力です。
完全な翻訳バージョン履歴または完全なリップシンク履歴が必要な場合は、GET /v1/projects/{projectId}を使用してください。

成功時のレスポンスフィールド

翻訳ワークフローの場合、statussuccessのときに以下のフィールドが含まれます。文字起こしのみのワークフローでは、翻訳済みメディアフィールドを含まずにsuccessに到達します。
string
翻訳済みビデオファイルをダウンロードするためのURL
string
翻訳済みオーディオファイルを個別にダウンロードするためのURL

失敗時のレスポンスフィールド

statusfailedのとき、以下の追加フィールドが含まれます:
object
エラーの詳細

レスポンスの例

処理ステータス

処理ステータス(Lip Syncリクエスト済み)

成功ステータス

成功ステータス(Lip Sync完了)

失敗ステータス

ポーリングのベストプラクティス

推奨ポーリング間隔: 10〜30秒翻訳時間はビデオの長さと複雑さによって異なります。一般的な2分間のビデオの場合、2〜5分の処理時間を見込んでください。
レート制限: 1分間に30リクエストレート制限内に収めるため、2秒に1回を超える頻度でのポーリングは避けてください。

エラー