# 1. upload the video once - YouTube, Drive, S3, Vimeo or direct URL
curl -X POST https://api.rask.ai/api/library/v1/media/link \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"link": "https://example.com/onboarding.mp4", "name": "onboarding"}'
# 2. one project per subtitle language
for lang in es-mx fr-fr ja-jp; do
curl -X POST https://api.rask.ai/v2/projects \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d "{\"video_id\": \"$VIDEO_ID\", \"dst_lang\": \"$lang\"}"
done# When status is merging_done, download both subtitle files
P=$(curl -s https://api.rask.ai/v2/projects/$ID -H "Authorization: Bearer $TOKEN")
curl -s -o onboarding.es-mx.srt "$(echo $P | jq -r .translation_srt_path)"
curl -s -o onboarding.es-mx.vtt "$(echo $P | jq -r .translation_vtt_path)"動画ファイルを送信するか、YouTube、Googleドライブ、S3、Vimeoなどのリンク、または直接URLを貼り付けます。1回のアップロードで、すべての言語の字幕に対応します。
メディアIDをvideo_idとして渡し、1プロジェクトにつき1つのターゲット言語を指定します。異なる言語のプロジェクトを同時に実行できます。
ステータスが「merging_done」になるまで読み込んだ後、.srtおよび.vttファイルをダウンロードして、ご自身の環境に保存します。
# pip install git+ssh://[email protected]/braskai/rask-sdk.git@main
import asyncio, urllib.request
from rask_sdk import clients, enums, schemas
LANGS = ["es-mx", "fr-fr", "ja-jp"]
async def subtitle(client, video_id, lang):
job = await client.create_project(data=schemas.ProjectCreate(video_id=video_id, dst_lang=lang))
while job.status is not enums.ProjectStatus.MERGING_DONE:
await asyncio.sleep(10)
job = await client.get_project(project_id=job.id)
# links are presigned for one hour - save the files right away
urllib.request.urlretrieve(job.translation_srt_path, f"video.{lang}.srt")
urllib.request.urlretrieve(job.translation_vtt_path, f"video.{lang}.vtt")
async def main():
client = clients.RaskSDKClient(client_id=CLIENT_ID, client_secret=CLIENT_SECRET)
media = await client.create_media_link(data=schemas.MediaCreateLink(link="https://example.com/onboarding.mp4"))
while media.status is enums.MediaStatus.PROCESSING:
await asyncio.sleep(5)
media = await client.get_media(media_id=media.id)
await asyncio.gather(*(subtitle(client, media.id, l) for l in LANGS))
asyncio.run(main())import 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}"}
pid = requests.post(f"{API}/v2/projects", headers=h,
json={"video_id": VIDEO_ID, "dst_lang": "de-de"}).json()["id"]
while (p := requests.get(f"{API}/v2/projects/{pid}", headers=h).json())["status"] != "merging_done":
time.sleep(10)
# translated subtitles: download the files
open("video.de-de.vtt", "wb").write(requests.get(p["translation_vtt_path"]).content)
# original-language captions: build a WebVTT file from the transcript segments
segs = requests.get(f"{API}/v2/projects/{pid}/transcription", headers=h).json()["segments"]
cues = [f"{s['start'].replace(',', '.')} --> {s['end'].replace(',', '.')}\n{s['src']['text']}" for s in segs]
open("video.en.vtt", "w").write("WEBVTT\n\n" + "\n\n".join(cues) + "\n")// no dependencies, Node 18+ global fetch
import { writeFile } from 'node:fs/promises';
const API = 'https://api.rask.ai';
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
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 call = (method, path, body) => fetch(API + path, { method, headers: h, body: body && JSON.stringify(body) }).then((r) => r.json());
const langs = ['es-mx', 'pt-br', 'ko-kr'];
const tracks = await Promise.all(langs.map(async (dst_lang) => {
let p = await call('POST', '/v2/projects', { video_id: VIDEO_ID, dst_lang });
while (p.status !== 'merging_done') { await sleep(10000); p = await call('GET', `/v2/projects/${p.id}`); }
const file = `subs/${dst_lang}.vtt`;
await writeFile(file, await ((await fetch(p.translation_vtt_path)).text()));
return `<track kind="subtitles" srclang="${dst_lang}" src="/${file}">`;
}));
console.log(tracks.join('\n')); // paste inside your <video> element# 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. create the project for one subtitle language
ID=$(curl -s -X POST https://api.rask.ai/v2/projects \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d "{\"video_id\": \"$VIDEO_ID\", \"dst_lang\": \"it-it\"}" | jq -r .id)
# 3. wait for merging_done
until [ "$(curl -s https://api.rask.ai/v2/projects/$ID -H "Authorization: Bearer $TOKEN" | jq -r .status)" = merging_done ]; do
sleep 10
done
# 4. save both subtitle files
P=$(curl -s https://api.rask.ai/v2/projects/$ID -H "Authorization: Bearer $TOKEN")
curl -s -o video.it-it.srt "$(echo $P | jq -r .translation_srt_path)"
curl -s -o video.it-it.vtt "$(echo $P | jq -r .translation_vtt_path)"<?php
use GuzzleHttp\Client;
$http = new Client(['base_uri' => 'https://api.rask.ai']);
$json = fn($r) => json_decode($r->getBody(), true);
$auth = $json((new Client)->post('https://rask-prod.auth.us-east-2.amazoncognito.com/oauth2/token',
['auth' => [$clientId, $clientSecret], 'form_params' => ['grant_type' => 'client_credentials']]));
$h = ['Authorization' => 'Bearer ' . $auth['access_token']];
foreach (['es-mx', 'tr-tr'] as $lang) {
$p = $json($http->post('/v2/projects', ['headers' => $h, 'json' => [
'video_id' => $videoId, 'dst_lang' => $lang]]));
while ($p['status'] !== 'merging_done') {
sleep(10);
$p = $json($http->get("/v2/projects/{$p['id']}", ['headers' => $h]));
}
// presigned links, valid for one hour
file_put_contents("video.$lang.srt", file_get_contents($p['translation_srt_path']));
file_put_contents("video.$lang.vtt", file_get_contents($p['translation_vtt_path']));
} 0s created
11s transcription_started
87s translation_started
99s voiceover_started
154s merging_started
165s merging_done

es-mx および es-es 同様に機能します。プロジェクトには glossary_versionが記録されるため、後から編集を行っても、完了した作業が勝手に変更されることはありません。はい。すべてのRaskプロジェクトで、ターゲット言語のSRTおよびWebVTT形式の字幕ファイルが提供されます。動画をアップロードし、言語ごとにプロジェクトを作成して、完了後にファイルをダウンロードしてください。
すべてのプロジェクトで、ターゲット言語のSRTファイルとWebVTT(VTT)ファイルの2つの形式を提供します。別のキャプション形式が必要な場合は、タイムスタンプ付きのJSONセグメントとして文字起こしデータを利用することもできます。
字幕ファイルはターゲット言語となります。元の言語のキャプションが必要な場合は、文字起こしセグメントをご利用ください。各セグメントには開始時間と終了時間が含まれており、数行のコードでSRTやVTTファイルに変換できます。
字幕は、75の元言語から、es-mx、pt-br、fr-caなどの地域と言語を含む135以上のオプションで利用可能です。1つのプロジェクトにつき1つのターゲット言語を指定できます。同じ動画から言語ごとにプロジェクトを作成してください。
まだです。このAPIは、お使いのプレイヤーや動画編集ソフト用の字幕ファイルを返します。字幕が焼き付けられた動画を取得するには、Raskのウェブアプリをご利用ください。
これらのファイルにはテキストとタイミング情報が含まれています。フォント、サイズ、色、位置は、動画プレーヤー、アプリ、または編集ソフトで設定されるため、1つの字幕ファイルをあらゆる場所で利用できます。
これらのファイルには、音声による台詞が含まれています。聴覚障害者や難聴者の視聴者向けの音楽や効果音の説明は自動的に生成されませんので、字幕編集の段階でご自身で追加してください。
各字幕セグメントには「SPEAKER_XX」という形式で話者ラベルが付くため、インタビューや対話の字幕を作成する際に話者の名前を追加できます。
API経由でセグメントのテキストやタイミングを修正し、プロジェクトを再生成します。字幕ファイルは、吹き替え版と一緒に更新されます。再生成の料金は変更されたセグメントに基づいて請求され、実行ごとに最小1分間の料金がかかります。
ダウンロードリンクには事前に署名がされており、有効期限は1時間です。ファイルを自分のストレージに保存するか、プロジェクトを再度取得して新しいリンクを発行してください。
はい。文字起こしインポート機能があるプランでは、プロジェクトの作成時に、元言語の字幕、承認済みの翻訳言語のSRT、あるいはその両方をアップロードできます。既存の字幕を元データとして使用することも、承認済みの翻訳を翻訳言語の字幕や吹き替え用にそのまま維持することも可能です。
プロジェクトの料金は動画の1分単位で計算され、次の1分に切り上げられます。料金はRaskアプリと共通の分数プールから差し引かれます。価格には、文字起こし、翻訳、字幕、吹き替え版が含まれます。対象となる標準プランでは、追加分数は1分あたり3ドルです。エンタープライズプランの価格は、ご契約内容に合わせて個別に調整されます。
APIアクセスは、クリエイタープロ、ビジネス、およびエンタープライズの各プランでご利用いただけます。利用できる機能はプランによって異なります。アプリ内でクライアントIDとシークレットを生成すれば、すぐにAPIの呼び出しを開始できます。エンタープライズ向けの契約条件、大量利用時の割引、カスタム言語の対応については、弊社のチームまでお問い合わせください。