はじめに
audio_url と翻訳先言語を指定し、ポッドキャスト、ボイスメモ、ナレーション、音声広告を翻訳します。分かる場合は元の言語と話者数を指定し、音楽や環境音を残すか選んでください。試聴・確認用の MP3 音声が返ります。
| 項目 | 値 |
|---|---|
| 入力 | 音声 |
| 出力 | 音声 |
| 開発元と製品 | ElevenLabs — ElevenLabs Dubbing |
| 公開日 | 2023 年 10 月 10 日 |
| 公開音声 API 名 | elevenlabs/dubbing/audio-to-audio |
| 公開動画 API 名 | elevenlabs/dubbing/video-translate |
| 素材の長さの上限 | 15 分、それ以上は送信時に拒否 |
| 翻訳先言語 | 33 言語、 |
| 翻訳元言語 | 57 言語と auto による自動検出 |
| 話者数 | 1〜32 人、 |
| 背景音 |
|
| 音声出力の実測 | MP3、音声テストで 4.50 秒、44.1 kHz、モノラル、128 kbps |
| 動画出力の実測 | MP4、6.04 秒、新しいモノラル AAC 音声、映像ストリームは元とバイト単位で一致 |
| 課金単位 | 元のメディアの秒数、端数は切り上げ |
主な機能とハイライト
MP3 の吹き替えか、翻訳音声付き MP4
audio-to-audio は録音から吹き替え MP3 を返します。video-translate は映像を保ち、音声トラックを差し替えた MP4 を返します。どちらも素材は最長 15 分で、受け取りたい形式に応じて選べます。
33 の翻訳先と話者の自動検出
翻訳先 33 言語、翻訳元 57 言語から選ぶか、元の言語を自動検出できます。登場する人数が分かるなら speaker_count を 1〜32 で指定し、不明なら省略してください。ElevenLabs は、各話者の声の特徴を翻訳音声へ引き継ぐと説明しています。
録音の音楽や環境音を残す
翻訳後も音楽や環境音が必要なら keep_background_audio を有効にします。結果を使う前に、新しい声との音量バランスを確認してください。動画でもこの設定で映像が変わったり字幕が作られたりすることはありません。
音声サンプルの処理時間は 9.6 秒
4.5 秒の英語をスペイン語に訳すテストは約 9.6 秒で処理され、4.50 秒、44.1 kHz、モノラル、128 kbps の MP3 が返りました。別の 6.04 秒の動画は約 14.8 秒かかり、新しいモノラル AAC を含む MP4 になりました。いずれもサンプルの観測です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
audio_url | はい |
|
target_language | いいえ | 対応する 33 の翻訳先から選びます。既定は en なので、スペイン語など英語以外が必要な場合は明示してください。 |
source_language | いいえ | 自動検出には auto、明示する場合は対応する 57 の翻訳元言語を選びます。言語が分かっている短いサンプルの確認には、明示的な指定が役立ちます。 |
speaker_count | いいえ | 異なる話者の人数を整数 1〜32 で指定するか、このフィールドを省いて自動検出します。インタビューでは発言回数ではなく人数を数えてください。 |
keep_background_audio | いいえ | 翻訳した話し声の下に音楽と環境音を残す場合は有効にします。納品前に、吹き替え音声と保持された背景音を一緒に聞いてください。 デフォルト値: |
料金
$0.012 / 秒
元の録音の長さを秒数で計算し、端数を整数秒に切り上げて課金します。素材は最長 15 分です。言語や話者の指定で単価は変わらず、失敗したタスクは課金されません。
ユースケース
インタビューをスペイン語版にする
12 分の英語インタビューを audio_url で送り、es と、司会者・ゲストに合わせた speaker_count 2 を指定します。翻訳 MP3 を確認してからスペイン語版に組み込めます。
顧客向けの音声報告を英語にする
翻訳に同意した同僚が録った 45 秒のボイスメモを、翻訳先 en で送ります。吹き替えた MP3 を受け取り、報告を共有する前に内容を確認できます。
教材の画面を保って音声を訳す
6 分の画面収録の教材を video_url で送り、目的の翻訳先を指定します。説明画面を保ち、話し声を差し替えた MP4 が返ります。必要な字幕は別途作成してください。
音楽入りの音声広告を翻訳する
使用権のある 30 秒の広告録音を使い、keep_background_audio を有効にします。翻訳した声の下に音楽や環境音を残した MP3 が返ります。
別の市場向けに製品デモを用意する
90 秒の製品操作動画を入力し、対応する翻訳先言語を選びます。同じ映像に吹き替え音声を重ねた MP4 を取得し、公開前の言語チェックに回せます。
プロンプトガイドと実践のヒント
許可のある録音を用意する
自分の録音か、吹き替えに同意した話者の素材から、15 分以内の音声または動画を選びます。話し声と音楽を利用する権利を確認してください。
言語と話者を指定する
33 の翻訳先から選び、翻訳元は自動検出か 57 言語のいずれかにします。人数が分かる場合は
speaker_countを 1〜32 で指定し、元の背景音を残すか決めてください。吹き替えタスクを送信する
Bearer 認証を使い、POST https://api.spicyapi.ai/api/v1/jobs/createTask に {"model":"elevenlabs/dubbing/audio-to-audio","input":{"
audio_url":"https://example.com/narration.mp3","target_language":"es"}} などの JSON を送ります。動画なら elevenlabs/dubbing/video-translate とvideo_urlを使ってください。メディアを取得して点検する
GET /api/v1/jobs/recordInfo?taskId= を state が succeeded になるまで確認し、返ったアセットをダウンロードします。翻訳された話し声と話者の切り替わりを点検してください。動画の口元は元の動きが残ります。
音声を翻訳する ElevenLabs Dubbing API
ElevenLabs Dubbing API は、録音を 33 の翻訳先言語のいずれかに吹き替えた MP3 にします。このエンドポイントは、15 分以内のポッドキャスト、ボイスメモ、ナレーション、音声広告に使えます。
ElevenLabs は吹き替えのドキュメントで、元の話者の声の特徴を保つとしています。実際の素材で似ているかを確認してください。当方の短いテストは出力形式と処理時間の観測であり、翻訳や声の品質を広く評価したものではありません。
音声吹き替えタスクを送る
公開モデル名 elevenlabs/dubbing/audio-to-audio を指定し、録音と言語設定を input に入れます。Authorization: Bearer <SPICY_API_KEY> と Content-Type: application/json を付け、以下の JSON を https://api.spicyapi.ai/api/v1/jobs/createTask に POST してください。
{
"model": "elevenlabs/dubbing/audio-to-audio",
"input": {
"audio_url": "https://example.com/english-interview.mp3",
"target_language": "es",
"source_language": "en",
"speaker_count": 2,
"keep_background_audio": true
}
}
この例は、背景音を残しつつ、話者 2 人の英語インタビューをスペイン語にする指定です。URL を自分の録音に置き換え、話者の自動検出を使う場合は speaker_count を省略してください。
完成した MP3 を読む
完了したタスクは、吹き替え MP3 を含むメディアアセットを返します。取得した taskId を GET /api/v1/jobs/recordInfo?taskId=<taskId> に指定し、同じ認証でタスクの状態を確認してからダウンロードしてください。
{
"code": 200,
"data": {
"taskId": "<taskId>",
"state": "succeeded",
"output": {
"assets": [
{
"url": "https://example.com/dubbed-interview.mp3",
"mime": "audio/mpeg"
}
]
}
}
}
このレスポンスは完了タスクの構造を示す抜粋で、URL は仮のものです。送信できただけでは録音は完成していないため、succeeded を待ってからアセットを使用可能と判断します。
音声パラメーターと上限
音声リクエストは必須の録音に、言語、話者、背景音の選択を組み合わせます。
| パラメーター | 指定できる値と範囲 | 使い方 |
|---|---|---|
audio_url | 最長 15 分の元音声 | 翻訳する権利のある録音を渡します |
target_language | 33 言語、既定は en | スペイン語の出力には es を指定します |
source_language | auto または 57 の翻訳元言語 | 既知の言語を指定するか検出に任せます |
speaker_count | 1〜32、省略すると自動検出 | インタビュー内の異なる人物を数えます |
keep_background_audio | 背景音を保持する切り替え | 吹き替え音声の下に音楽や環境音を残します |
15 分を超える録音は送信時に拒否されます。長いエピソードは話題や話者の区切りで分割し、訳した部分をつなぐ際に接続箇所を確認してください。
元音声の長さによる料金
音声吹き替えは元の録音の秒数を整数秒に切り上げて課金します。予算を立てる際はページの表示価格をご覧ください。処理を待つ時間は、課金されるメディアの長さではありません。
計算の基準は送信した素材の長さで、MP3 のファイルサイズではありません。不慣れな言語や難しい話者の切り替わりを評価するときは、長い録音を送る前に短い抜粋を用意してください。
英語からスペイン語への音声テスト
4.5 秒の英語音声から、約 9.6 秒の処理で 4.50 秒のスペイン語 MP3 が返りました。出力は 44.1 kHz、1 チャンネル、128 kbps でした。
長さが一致したのはこのサンプルであり、どの翻訳でも同じタイミングになると確認できたわけではありません。15 分のポッドキャストの処理時間や、33 の翻訳先言語すべての結果を示すものでもありません。
録音を整え、吹き替えを確認する
明瞭な会話と確認の計画があると、翻訳された録音が対象の聞き手に適しているかを判断しやすくなります。プロジェクトで大切な名前、用語、話者の交代を含む代表的な抜粋を選んでください。
- 聞き取りやすい一節を選び、話者の許可を確認します。
- 分かっている元の言語を設定し、翻訳先も明示します。
- 人数が分かる場合は話者数を指定し、不明なら省略して検出させます。
- 納品に背景音楽が必要かを決め、保持の設定を合わせます。
- 翻訳先の言語に詳しい人に、意味、発音、話者の切り替わりを確認してもらいます。
雑音の少ないナレーションのサンプルでは、声が重なるインタビューの挙動は分かりません。割り込みを聞き、訳された各せりふを誰が話しているか比較してください。話者数の指定はその確認の代わりにはなりません。
問題への対処と別の処理の選択
拒否されたリクエストを再送する前に、素材の長さや範囲外の話者数を修正します。タスクが失敗した場合はエラーの詳細を読み、録音と言語の選択を確認してから再試行してください。
元の映像に翻訳音声を重ねた MP4 が必要なら elevenlabs/dubbing/video-translate を選びます。口の動きも必要な動画には HeyGen Video Translate を検討できます。Video Translator V1 も動画翻訳の選択肢です。自分自身または同意した話者の録音を使い、実在の人物をかたらないでください。
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": "elevenlabs/dubbing/audio-to-audio",
"input": {
"audio_url": "https://example.com/reference.mp3",
"source_language": "auto",
"target_language": "en"
}
}'
# 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 リファレンスを参照してください。




