# 1. exchange client credentials for a token (valid 1 hour)
curl -X POST https://rask-prod.auth.us-east-2.amazoncognito.com/oauth2/token \
-u "$CLIENT_ID:$CLIENT_SECRET" \
-d "grant_type=client_credentials"# 2. upload by link - YouTube, Drive, S3, Vimeo or direct URL
curl -X POST https://api.rask.ai/api/library/v1/media/link \
-H "Authorization: Bearer $TOKEN" \
-d '{"link": "https://youtu.be/...", "name": "Q3 launch"}'# 3. create the dubbing project - this starts the dub
curl -X POST https://api.rask.ai/v2/projects \
-H "Authorization: Bearer $TOKEN" \
-d '{
"video_id": "b8f7835d-e8c9-4ff4-8e34-5c336d818319",
"dst_lang": "es-mx",
"name": "Q3 launch"
}'# Poll the project until status is merging_done.while :; do
curl -s https://api.rask.ai/v2/projects/$ID \
-H "Authorization: Bearer $TOKEN" | jq .status
sleep 10doneマルチパートフォームデータとしてファイルを送信するか、リンクを投稿します。サポートされているリンクのソースは、YouTube、Google Drive、S3、Vimeo、および直接ダウンロードURLです。費用が発生する前に、メディアIDと完全な技術的メタデータが返されます。
メディアIDをvideo_idとして渡し、ターゲット言語を指定します。オプションで独自の文字起こしや用語集を添付することもできます。ダビングはすぐに開始されます。
statusがmerging_doneに達するまで確認し、ダビングされた動画、音声トラック、字幕ファイルをダウンロードします。
# pip install git+https://github.com/braskai/rask-sdk
import asyncio
from rask_sdk import RaskSDKClient
async def main():
client = RaskSDKClient(client_id=CLIENT_ID, client_secret=CLIENT_SECRET)
media = await client.upload_media_link(link="https://youtu.be/...")
project = await client.create_project(video_id=media.id, dst_lang="es-mx")
while project.status != "merging_done":
await asyncio.sleep(10)
project = await client.get_project(project.id)
print(project.translated_video, project.translation_srt_path)
asyncio.run(main())import os, time, requests
AUTH = "https://rask-prod.auth.us-east-2.amazoncognito.com/oauth2/token"
API = "https://api.rask.ai"
token = requests.post(AUTH, auth=(CLIENT_ID, CLIENT_SECRET),
data={"grant_type": "client_credentials"}).json()["access_token"]
h = {"Authorization": f"Bearer {token}"}
media = requests.post(f"{API}/api/library/v1/media/link", headers=h,
json={"link": "https://youtu.be/..."}).json()
project = requests.post(f"{API}/v2/projects", headers=h,
json={"video_id": media["id"], "dst_lang": "es-mx"}).json()
while project["status"] != "merging_done":
time.sleep(10)
project = requests.get(f"{API}/v2/projects/{project['id']}", headers=h).json()
print(project["translated_video"])// no dependencies, Node 18+ global fetch
const API = 'https://api.rask.ai';
const auth = await fetch('https://rask-prod.auth.us-east-2.amazoncognito.com/oauth2/token', {
method: 'POST',
headers: { Authorization: 'Basic ' + btoa(`${CLIENT_ID}:${CLIENT_SECRET}`) },
body: new URLSearchParams({ grant_type: 'client_credentials' }),
}).then(r => r.json());
const h = { Authorization: `Bearer ${auth.access_token}`, 'Content-Type': 'application/json' };
const media = await fetch(`${API}/api/library/v1/media/link`, {
method: 'POST', headers: h,
body: JSON.stringify({ link: 'https://youtu.be/...' }),
}).then(r => r.json());
let project = await fetch(`${API}/v2/projects`, {
method: 'POST', headers: h,
body: JSON.stringify({ video_id: media.id, dst_lang: 'es-mx' }),
}).then(r => r.json());
while (project.status !== 'merging_done') {
await new Promise(r => setTimeout(r, 10000));
project = await fetch(`${API}/v2/projects/${project.id}`, { headers: h }).then(r => r.json());
}
console.log(project.translated_video);# 1. token (valid 1 hour - cache and reuse it)
TOKEN=$(curl -s -X POST https://rask-prod.auth.us-east-2.amazoncognito.com/oauth2/token \
-u "$CLIENT_ID:$CLIENT_SECRET" \
-d "grant_type=client_credentials" | jq -r .access_token)
# 2. upload by link
VIDEO_ID=$(curl -s -X POST https://api.rask.ai/api/library/v1/media/link \
-H "Authorization: Bearer $TOKEN" \
-d '{"link": "https://youtu.be/..."}' | jq -r .id)
# 3. create the dubbing project
ID=$(curl -s -X POST https://api.rask.ai/v2/projects \
-H "Authorization: Bearer $TOKEN" \
-d "{\"video_id\": \"$VIDEO_ID\", \"dst_lang\": \"es-mx\"}" | jq -r .id)
# 4. poll, then download
while [ "$(curl -s https://api.rask.ai/v2/projects/$ID -H "Authorization: Bearer $TOKEN" | jq -r .status)" != "merging_done" ]; do
sleep 10
done<?php
use GuzzleHttp\Client;
$http = new Client(['base_uri' => 'https://api.rask.ai']);
$auth = json_decode((new Client)->post(
'https://rask-prod.auth.us-east-2.amazoncognito.com/oauth2/token',
['auth' => [$clientId, $clientSecret],
'form_params' => ['grant_type' => 'client_credentials']]
)->getBody(), true);
$h = ['Authorization' => 'Bearer ' . $auth['access_token']];
$media = json_decode($http->post('/api/library/v1/media/link',
['headers' => $h, 'json' => ['link' => 'https://youtu.be/...']])->getBody(), true);
$project = json_decode($http->post('/v2/projects',
['headers' => $h, 'json' => ['video_id' => $media['id'], 'dst_lang' => 'es-mx']])->getBody(), true);
while ($project['status'] !== 'merging_done') {
sleep(10);
$project = json_decode($http->get("/v2/projects/{$project['id']}",
['headers' => $h])->getBody(), true);
} 0s created
12s transcription_started
70s translation_started
95s voiceover_started
150s merging_started
170s merging_done

es-mx および es-es 同様に機能します。プロジェクトには glossary_versionが記録されるため、後から編集を行っても、完了した作業が勝手に変更されることはありません。APIへのアクセスは有料プランに含まれています。アプリ内でクライアントIDとシークレットを生成し、すぐに呼び出しを開始できます。企業向けの契約条件、大量利用の割引価格、カスタム言語の対応については、弊社チームまでお問い合わせください。
OAuth 2.0のクライアント認証情報を使用し、クライアントIDとシークレットを有効期間の短いベアラー・トークンに交換します。トークンは1時間有効なので、キャッシュして再利用してください。
非同期処理に対応しています。プロジェクトを作成するとすぐに処理が返され、吹き替えが開始されます。ステータスが「merging_done」になるまでGET /v2/projects/{id}を定期的に確認してください。Webhookによる通知は、エンタープライズ向けプランの導入時に設定されます。
すべてのリクエストは送信された通りに受け付けられます。処理速度は混雑状況によって変わり、優先的な処理はエンタープライズ向けの条件に含まれます。
スペイン語、フランス語、ドイツ語、ポルトガル語、ヒンディー語、日本語、韓国語など135以上の言語に対応しており、必要に応じて地域の方言も選べます(例:「es」ではなく「es-mx」を指定)。元の言語は自動で検出されますが、手動で設定することも可能です。対応言語の詳しいリストはAPIドキュメントに記載されています。リストにない言語については、実現可能性やオプションについて当社チームにお問い合わせください。
「インスタント音声クローン」機能では、対応しているターゲット言語において、元の動画にいる話者の声をそのまま使用します。何度でも使える「カスタム音声クローン」を作成するには、Raskアプリで話者の同意を得て作成し、API経由で割り当てます。結果は、元の音声の状態や選択した言語、声の種類によって異なります。
動画の長さ、話者の人数、翻訳先の言語、サーバーの混雑状況によって異なります。文字起こしから動画の結合までの各段階でプロジェクトの進捗状況が確認できるため、ユーザーに進捗をわかりやすく伝えることができます。
7つの動画形式(MP4、MOV、MKV、AVI、WebM、M4V、3GP)と4つの音声形式(MP3、WAV、FLAC、M4A)に対応しています。また、ファイルをアップロードする代わりに、YouTube、Googleドライブ、S3、Vimeo、または直接のURLから読み込むこともできます。
元の音声から話者が自動的に検出・分離され、ターゲット言語でそれぞれに固有の声が割り当てられます。話者ごとの割り当てを変更することも、事前に人数が分かっている場合はプロジェクト作成時に「num_speakers」を渡すこともできます。
.srtファイルをアップロードして文字起こしデータを作成し、プロジェクト作成時にそのIDを指定することができます。また、APIに文字起こしを任せてから、台本を1文ずつ編集することも可能です。
完成したすべてのプロジェクトでは、動画や音声トラックに加えて、.srtと.vttの両方の形式の字幕ファイルが吹き替えに合わせてタイミングよく出力されます。
GitHubで公開されている公式の非同期Python SDKは、安定した互換性のあるインターフェースを備えています。他の言語を使用する場合は、公開されているOpenAPI仕様書からクライアントを生成してください。ノーコードで連携できるn8n用のノードも用意されています。
変更された部分のみが対象となります。編集や追加が行われた部分の長さを合計し、1分単位で切り上げるため、数行の修正であれば約1分分の費用となります。