Skip to main content
POST
cURL
POST /runwayml/v1/voice_dubbing を使用して、話し声の音声を別の 言語に翻訳します。モデル ID には eleven_voice_dubbing を使用します。 CometAPI API キーを Bearer 認証と JSON リクエスト本文で送信します。

音声と対象言語を指定する

audioUri には、ソース音声のアクセス可能な HTTPS URL を設定します。 targetLang には宛先言語コードを設定します。たとえば、スペイン語の場合は es 、フランス語の場合は fr を指定します。リクエストスキーマからサポートされているコードを選択してください。 このリクエストには modelaudioUri、および targetLang が必要です。 サンプルの音声 URL をソースファイルに置き換えます。

吹き替えを設定する

ブール値のコントロールを省略すると、モデルのデフォルト設定が使用されます。false を送信した場合も デフォルト設定が使用されます。

結果を取得する

返された id を保存し、次に Runway タスクを取得 してタスクのステータスを取得します。statusSUCCEEDED の場合、音声 URL は次にあります: output。タスクが失敗した場合は、failurefailureCode を確認します。

承認

Authorization
string
header
必須

Use your CometAPI API key.

ボディ

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
必須

Model ID for this request.

利用可能なオプション:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
必須

Audio input as an accessible HTTPS URL or base64 data URI.

Required string length: 13 - 2048
Pattern: ^https:\/\/.*
targetLang
enum<string>
必須

The target language code to dub the audio to (e.g., "es" for Spanish, "fr" for French).

利用可能なオプション:
en,
hi,
pt,
zh,
es,
fr,
de,
ja,
ar,
ru,
ko,
id,
it,
nl,
tr,
pl,
sv,
fil,
ms,
ro,
uk,
el,
cs,
da,
fi,
bg,
hr,
sk,
ta
disableVoiceCloning
boolean

Set true to use a generic voice instead of cloning the source voice. Omit or use false for the model default.

dropBackgroundAudio
boolean

Set true to remove background audio from the dubbed output. Omit or use false for the model default.

numSpeakers
integer

Number of speakers in the source audio. Supply a positive integer or omit it for automatic detection.

必須範囲: x <= 9007199254740991

レスポンス

Task created. Save the returned id to retrieve task status.

id
string
必須

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

最終更新日 2026年9月18日