はじめに
Video Translator は、話している動画クリップを別の言語に吹き替えます。映像を video_url で送り、target_language を選んでください。ツールが音声を書き起こして翻訳し、元のセリフのタイミングに合わせて話し直して、新しい音声を付けた同じ映像を返します。clone_voice をオンにすると、各話者は本人の声を模した声を保ちます。
主な機能とハイライト
話者は本人の声のまま
clone_voice をオンにすると、吹き替えは各話者本人の声から作られた声で話されます。2 人のテストでは、女性と男性がそれぞれ自分の声色のままスペイン語で返ってきて、各セリフは元のセリフが始まった場所から始まりました。
音楽を残すか、取り除くか
keep_background_audio で、吹き替えの下に何を残すかを決めます。オンなら、地下室の環境音や部屋の響きはそのまま残ります。オフなら、返されるクリップには翻訳された声だけが入り、セリフの間は完全な無音になるので、自分のミックスに使えます。
固有名詞はそのまま
glossary に {term, translation} のペアで用語を入れると、毎回その訳し方で翻訳されます。テストでは、用語集に入れた言い回しが、現れた 2 つのセリフの両方でそのまま使われました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 翻訳するクリップ。1 秒から 10 分です。 1 文字以上 |
target_language | いいえ | 吹き替え先の言語。28 言語から 1 つ選びます。 |
source_language | いいえ | クリップで話されている言語。既定値は auto で、自動判定します。 |
clone_voice | いいえ | 既定ではオフです。オンにすると、各話者は本人の声を模した声で話し直されます。 デフォルト値: |
keep_background_audio | いいえ | 既定ではオンで、音楽と効果音は吹き替えの下に残ります。オフにすると、翻訳された声だけが返され、セリフの間は無音になります。 デフォルト値: |
speaker_count | いいえ | クリップで話している人数。1 から 4。 |
glossary | いいえ | 名前、ブランド、定型句を、固定の訳語と一緒に term / translation のペアで指定します。最大 100 件。 100 件以内 |
料金
$0.005 / 出力秒
元のクリップの長さを、開始した分単位で切り上げて課金します。たとえば 70 秒のクリップは 2 分と同じ料金です。クリップの長さは 1 秒から 10 分である必要があります。送信前の見積もりは、アップロードしたクリップの実際の長さか、動画 URL の場合は上限の 10 分を使います。見積もりとの差額は、タスクの確定時に解放されます。クローン音声や背景の削除などのオプションは料金を変えません。
ユースケース
ショート動画のローカライズ
同じクリップを、言語の異なる複数の市場に投稿できます。声優を言語ごとに手配する必要はありません。1 分未満のクリップは 1 分の料金です。
動画モデルのキャラクターの吹き替え
英語で話す生成キャラクターを、キャラクターの声を保ったまま、視聴者の言語に吹き替えられます。
プロンプトガイドと実践のヒント
音楽があるときは話している言語を指定する
自動判定は、クリーンな音声ではよく機能します。ささやくフランス語のセリフの下にギターが流れるクリップでは判定が失敗し、タスクは失敗（返金）しました。同じクリップを source_language を French に設定して送ると通りました。処理に関するメッセージでタスクが失敗した場合は、source_language を指定して送り直してください。
何人が話しているかを伝える
speaker_count は任意ですが、2 人の対話で指定すると、各セリフが正しい声に割り当てられます。
映像について
替えられるのは音声だけです。口の動きが重要なクローズアップでは、吹き替え後のクリップを Lip Sync ツールに通してください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-translator-v1/video-translate",
"input": {
"source_language": "auto",
"target_language": "en",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
