# 1. send the video as a link - YouTube, Google Drive, Vimeo, S3 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://youtu.be/...", "name": "camera review"}'
# 2. create the project - the language of the video is detected automatically
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\": \"es-mx\"}"# The transcript as plain text with timestamps and speakers
curl -s https://api.rask.ai/v2/projects/$ID/transcription -H "Authorization: Bearer $TOKEN" \
| jq -r '.segments[] | "\(.start) \(.speaker): \(.src.text)"'マルチパートフォームデータとして動画ファイルをアップロードするか、YouTube、Googleドライブ、Vimeo、S3などの直リンクを投稿します。料金が発生する前に、メディアIDと動画のメタデータを確認できます。
メディアIDを video_id として渡し、翻訳先の言語を指定します。翻訳元の言語は空欄にすると、自動で言語が検出されます。すぐに文字起こしが開始されます。video_id
文字起こしのセグメントは準備ができ次第すぐに確認できるため、翻訳されたメディアの処理が進んでいる間に、録画のインデックス作成を開始できます。プロジェクトが完了したら、字幕とメディアファイルをダウンロードしてください。
# pip install git+ssh://[email protected]/braskai/rask-sdk.git@main
import asyncio
from rask_sdk import clients, enums, schemas
VIDEOS = ["https://youtu.be/aaa", "https://youtu.be/bbb", "https://vimeo.com/123"]
async def transcribe(client, i, link):
media = await client.create_media_link(data=schemas.MediaCreateLink(link=link))
while media.status is enums.MediaStatus.PROCESSING:
await asyncio.sleep(5)
media = await client.get_media(media_id=media.id)
job = await client.create_project(data=schemas.ProjectCreate(video_id=media.id, dst_lang="en-us"))
while job.status is not enums.ProjectStatus.MERGING_DONE:
await asyncio.sleep(10)
job = await client.get_project(project_id=job.id)
t = await client.get_project_transcription(project_id=job.id)
with open(f"video_{i}.txt", "w") as f: # plain text, one segment per line
f.write("\n".join(f"{s.speaker}: {s.src.text}" for s in t.segments))
async def main():
client = clients.RaskSDKClient(client_id=CLIENT_ID, client_secret=CLIENT_SECRET)
await asyncio.gather(*(transcribe(client, i, v) for i, v in enumerate(VIDEOS))) # no rate limits
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 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());
let media = await call('POST', '/api/library/v1/media/link', { link: 'https://drive.google.com/file/d/...' });
while (media.status === 'processing') { await sleep(5000); media = await call('GET', `/api/library/v1/media/${media.id}`); }
let p = await call('POST', '/v2/projects', { video_id: media.id, dst_lang: 'fr-fr' });
while (p.status !== 'merging_done') { await sleep(10000); p = await call('GET', `/v2/projects/${p.id}`); }
const { segments } = await call('GET', `/v2/projects/${p.id}/transcription`);
const index = segments.map((s) => ({ t: s.start, speaker: s.speaker, text: s.src.text, fr: s.dst.text }));
console.log(JSON.stringify(index, null, 2)); // ready for your search index# 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 a local video file
VIDEO_ID=$(curl -s -X POST "https://api.rask.ai/api/library/v1/media?kind=video" \
-H "Authorization: Bearer $TOKEN" -F "[email protected]" | jq -r .id)
# 3. create the project once the media status is ready
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\": \"de-de\", \"num_speakers\": 3}" | jq -r .id)
# 4. when status is merging_done, save the transcript as plain text
curl -s https://api.rask.ai/v2/projects/$ID/transcription -H "Authorization: Bearer $TOKEN" \
| jq -r '.segments[].src.text' > webinar.txt<?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']];
$media = $json($http->post('/api/library/v1/media/link', ['headers' => $h, 'json' => [
'link' => 'https://vimeo.com/123456']]));
while ($media['status'] === 'processing') {
sleep(5);
$media = $json($http->get("/api/library/v1/media/{$media['id']}", ['headers' => $h]));
}
$p = $json($http->post('/v2/projects', ['headers' => $h, 'json' => [
'video_id' => $media['id'], 'dst_lang' => 'pt-br']]));
while ($p['status'] !== 'merging_done') {
sleep(10);
$p = $json($http->get("/v2/projects/{$p['id']}", ['headers' => $h]));
}
$t = $json($http->get("/v2/projects/{$p['id']}/transcription", ['headers' => $h]));
file_put_contents('video.txt', implode("\n", array_map(fn($s) => $s['src']['text'], $t['segments'])));no_audio, no_words and forbidden_link are specific enough to show directly to your own user, for example a video without speech.00:00:00,320 SPEAKER_00 Welcome back. Today we test three cameras in low light.
00:00:06,180 SPEAKER_01 I brought the footage from last week's night shoot.
00:00:10,940 SPEAKER_00 Let's start with the smallest sensor, the hardest case.
00:00:15,500 SPEAKER_01 At ISO 6400 the noise is visible, but the colors hold up./transcriptiontranslation_srt_pathtranslation_vtt_pathtranslated_videotranslated_audiooriginal_video

es-mx および es-es 同様に。プロジェクトの記録 glossary_versionのため、後から編集しても完成した作業が勝手に変更されることはありません。はい。動画ファイルまたはリンクを送信してプロジェクトを作成すると、GET /v2/projects/{id}/transcriptionから、話者ラベルとタイムスタンプ付きの文字起こしデータを取得できます。文字起こしはすべてのRaskプロジェクトの最初のステップであり、その後、翻訳、字幕、音声吹き替えが追加されます。
はい。YouTube、Googleドライブ、Vimeo、S3、または直接ダウンロードできるリンクをメディア用エンドポイントに送信すると、APIが自動で動画を取得します。また、動画ファイルを直接アップロードすることも可能です。
はい。動画ごとにプロジェクトを作成し、並行して実行できます。APIには利用制限や同時実行数のクォータ、キーごとのスロットルがないため、ライブラリ全体の大量の文字起こしも、コード内の1つのループ処理で簡単に実行できます。
話者は自動で識別され、各セグメントにはSPEAKER_00のような話者ラベルが付与されます。話者の数が事前に分かっている場合は、プロジェクト作成時にnum_speakersを指定してください。
APIは英語を含む75言語のソース言語に対応し、言語の自動検出機能も備えています。src_langを空欄にするか、「en」などの2文字のコードを指定してください。文字起こししたテキストは、135以上の言語や地域設定(en-usやes-mxなど)に翻訳できます。
精度は動画の状態(背景の雑音、騒がしい環境、話者の声の重なり、アクセント、専門用語など)によって異なります。実際の動画でAPIをテストし、必要に応じて公開前にAPI経由でセグメントを修正してください。
文字起こしデータは、話者情報とタイムスタンプが含まれるJSONセグメントとして取得できます。セグメントのテキストを結合すればプレーンテキストになり、タイムスタンプをそのまま残せば検索可能な文字起こしとして利用できます。ターゲット言語のSRTおよびVTT形式の字幕も含まれています。
いいえ。APIが返すのは文字起こし、その翻訳、字幕、吹き替え版です。AIによる要約や議事録を作成したい場合は、取得した文字起こしをお好みの要約ツールに入力してください。
録音データであれば可能です。録音された会議を動画ファイルまたは音声ファイルとしてアップロードしてください。なお、このAPIは会議プラットフォームと直接連携するものではなく、リアルタイム字幕やライブ通話の低遅延文字起こしには対応していません。
APIドキュメントには固定のファイルサイズ制限は記載されていません。各プロジェクトでは、プランの制限が適用された後の元の長さ(original_duration)と長さ(duration)が報告されます。非常に長い動画や大容量データを扱う場合は、当社のチームまでお問い合わせください。
料金は動画の再生時間(1分未満は切り上げ)に基づいて計算され、Raskアプリと共通の分数プールから消費されます。料金には文字起こし、翻訳、字幕、吹き替えが含まれます。対象となるスタンダードプランでは、追加分数は1分あたり3ドルとなります。エンタープライズプランの価格はご契約内容に応じて個別に対応いたします。
Raskアプリの無料トライアル(クレジットカード不要)から始めて、ご自身の動画で文字起こしをお試しください。APIアクセスはCreator Pro、Business、Enterpriseプランでご利用いただけ、利用できる機能はプランによって異なります。
APIアクセスはCreator Pro、Business、Enterpriseプランでご利用いただけ、利用できる機能はプランによって異なります。アプリ内でクライアントIDとシークレットを生成すれば、すぐに呼び出しを開始できます。Enterpriseプラン、ボリュームディスカウント、カスタム言語への対応については、当社チームまでお問い合わせください。