API pro titulky pro přeložené soubory SRT a VTT

Nahrávejte videa jednoduše a získejte soubory titulků ve formátech SRT a WebVTT pro každý cílový jazyk, přesně načasované podle mluveného slova. Opravte libovolný řádek přes API a stáhněte si aktualizované soubory pro váš přehrávač, aplikaci nebo software pro střih videa.
SRT a WebVTT
Více než 135 jazyků a regionálních možností
REST + Python SDK
upload, create, download
OAuth 2.0
# 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
GET /v2/projects/{project_id}
.srt + .vtt
# 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)"
Používají týmy po celém světě
Možnosti

Vše, co API pro titulky vrací

Vytvářejte přeložené soubory SRT a WebVTT z video nebo audio nahrávek, včetně podcastů a rozhovorů. Zvolte pro každý projekt cílový jazyk a získejte soubory titulků spolu s přepisem, překladem a nadabovaným obsahem.

Soubory SRT a WebVTT

Každý dokončený projekt vrací soubor .srt a .vtt v cílovém jazyce: SRT pro software na střih videa a většinu platforem, WebVTT pro přehrávání videa na webu.

Titulky v jiném jazyce

Odstraňte jazykové bariéry pro diváky na všech trzích: vytvořte z jednoho nahrání jeden projekt pro každý cílový jazyk, jako je španělština, portugalština nebo francouzština. Původní jazyk se detekuje automaticky.

Načasováno podle mluveného slova

Každý titulek odpovídá segmentu přepisu s počátečním a koncovým časem, takže se každý řádek objeví na obrazovce přesně v okamžiku, kdy je vysloven.

Titulky v původním jazyce

Přepis obsahuje původní text každého segmentu s časovými značkami. Převeďte jej na soubor SRT nebo VTT pro titulky ve stejném jazyce pomocí několika řádků kódu.

Označení mluvčích pro dialogy

Každý segment přepisu nese označení mluvčího, takže můžete do titulků pro rozhovory, panely a dialogy přidat identifikaci mluvčích.

Úprava řádku před zveřejněním

Opravte text nebo načasování kteréhokoli segmentu prostřednictvím API a proveďte novou generaci. Nejasná slova, jména a přízvuky lze opravit jednou pro všechny formáty.

Konzistentní termíny v každém jazyce

Slovník udržuje názvy produktů a odborné termíny stejné ve všech jazycích titulků nebo záměrně v původním jazyce.

Titulky a dabovaná verze

Ze stejného projektu získáte také přeložené video a zvukové stopy, takže titulky i dabovanou verzi máte z jediného nahrání.

Růst bez omezení

Žádná omezení rychlosti, žádné limity souběžnosti. Vytvořte titulky pro celou svou videotéku ve všech cílových jazycích paralelně.
Podívejte se na to v praxi

Jedno video, pět jazykových verzí

Stejný klip v angličtině, francouzštině, němčině, portugalštině a španělštině. Ke každé jazykové verzi získáte vlastní soubory s titulky ve formátu SRT a VTT.
EN flag
En
FR flag
Fr
DE flag
De
PT flag
Pt
ES flag
Es
Pracovní postup

Tři kroky od nahrání videa až po soubor s titulky

Vytvoření projektu spustí přepis, překlad a dabovanou verzi najednou. Po úpravě řádků titulků použijte koncový bod /generate.
1

Nahrajte své video

Pošlete video jako soubor nebo vložte odkaz z YouTube, Google Drive, S3, Vimeo či jakoukoli přímou URL adresu. Jedno nahrání stačí pro všechny jazyky titulků.

POST /api/library/v1/media/link
2

Vytvořit projekt

Předajte ID média jako video_id a jeden cílový jazyk na projekt. Projekty pro různé jazyky běží současně.

POST /v2/projects
3

Stáhnout soubory s titulky

Sledujte stav, dokud nedosáhne hodnoty merging_done, poté stáhněte soubory .srt a .vtt a uložte si je k sobě.

GET /v2/projects/{project_id}
Doba zpracování závisí na délce videa, počtu mluvčích a cílovém jazyce. V jednom sledovaném případě bylo 3:47 dlouhé video hotové za 165 sekund.
Navrženo pro vás

Chybí vám formát titulků nebo možnost doručení v seznamu? Domluvte si schůzku s naším týmem

Jiný formát titulků, doručení do vašeho vlastního úložiště, jazyk mimo nabídku nebo vyšší výkon: náš tým posoudí potřeby vašeho pracovního postupu a dostupné možnosti.

Jazyky a hlasy

Potřebujete titulky v jazyce, který není v naší veřejné nabídce? Řekněte nám o svých požadavcích a probereme dostupné možnosti.

Doručení a integrace

Webhooky, odesílání do vlastní fronty, doručení přímo do vašeho úložiště S3 nebo vlastní koncové body. Řekněte nám, jak váš systém potřebuje data přijímat.

Objem a propustnost

Velikost dávek, cílové jazyky na jednu akci a priorita zpracování jsou smluvní podmínky, nikoli pevné limity produktu.

Zabezpečení a hostování

Umístění dat, jednotné přihlašování (SSO a SAML), pravidla uchovávání a podpora bezpečnostních kontrol jsou součástí firemního nastavení.
Případy použití

Kdo používá API pro titulky

Platformy pracující s videem

Platformy LMS a pro vzdělávání zákazníků, tvůrčí a video platformy, nástroje pro webináře a virtuální akce, video hosting a pracovní SaaS nástroje, platformy pro digitální osvojení, živé nakupování. Proměňte titulky v libovolném jazyce ve funkci pro vaše nahraná videa.

Lokalizační a produkční agentury

Poskytněte soubory SRT a VTT pro každý jazyk klienta z jediného nahrání. Kontroloři opravují řádky přes API a soubory se aktualizují, aniž by je kdokoli musel znovu časovat.

Vlastní nepřetržitá produkce videí

Mezinárodní maloobchod a e-commerce, globální franšízy, mediální vydavatelství, firemní univerzity. Zpřístupněte školicí a produktové videonahrávky každému trhu a divákům, kteří sledují videa bez zvuku.
Příběhy zákazníků

Skutečné týmy, měřitelné výsledky

Jak společnosti lokalizují videa s Rask AI, vyjádřeno vlastními čísly.
šipka
šipka
Kód

Příklady kódu pro API titulků

Jeden kompletní příklad v každém jazyce: nahrát video, vytvořit projekt pro každý jazyk titulků, počkat a poté uložit soubory .srt a .vtt nebo je přidat do přehrávače HTML5.
# 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())
github.com/braskai/rask-sdk
async, typed models
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")
requests + polling
same-language captions
// 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
fetch, Node 18+
HTML5 track elements
# 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)"
download .srt and .vtt
shell script
<?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']));
}
Guzzle 7
plain HTTP
Python je oficiální SDK. Karty Node, PHP a cURL představují jednoduché příklady HTTP pro stejné koncové body.
Průběh

Jak projekt titulků hlásí svůj postup

Každý projekt prochází zdokumentovanými stavy, takže uživatelé, kteří nahrávají video do vaší aplikace, mohou sledovat průběh u každého jazyka titulků. Reagovat musíte pouze na tři skupiny.

Hotovo, zde skončete

merging_done
Soubory s titulky jsou připraveny. Načtěte projekt ještě jednou a získejte nové odkazy ke stažení.

Probíhá zpracování, kontrolujte stav

created
uploading
transcription_started
separate_background_started
determine_speakers_started
translation_started
voiceover_started
merging_started
Navíc odpovídající _done stavy. Tyto prvky lze skvěle začlenit do uživatelského rozhraní s fázovaným postupem.

Chyba, zastavte a nahlaste problém

failed
upload_failed
transcription_failed
translation_failed
voiceover_failed
merging_failed
no_audio
no_words
forbidden_link
no_audio, no_words a forbidden_link jsou dostatečně konkrétní na to, abyste je mohli ukázat přímo svým uživatelům.
Observed run, 3:47 source video, en → es-mx
GET /v2/projects/{project_id}
   0s  created
  11s  transcription_started
  87s  translation_started
  99s  voiceover_started
 154s  merging_started
 165s  merging_done

Nebo kontrolu stavu zcela vynechte

Stačí nám zadat koncový bod webhooku a každá změna stavu dorazí jako požadavek POST, takže vaše fronta reaguje na každou změnu ihned, jak k ní dojde. Doručování webhooků je součástí procesu zapojení podnikových zákazníků.
Přečíst dokumentaci
preserveAspectRatio="xMidYMid meet" aria-hidden="true" role="img">
Výstup

Nejprve soubory s titulky, vše ostatní hned vedle

Každý dokončený projekt nabízí oba formáty titulků, související části přepisu a dabované média. Odkazy ke stažení jsou předem podepsané a platné jednu hodinu, takže si soubory zkopírujte do vlastního úložiště.
Položka
Formát
Popis
translation_srt_path
.srt
Titulky v cílovém jazyce pro editační software a většinu video platforem
translation_vtt_path
.vtt
Titulky WebVTT pro přehrávání videa v HTML5 a webových přehrávačích
/transcription
JSON
Zdrojový text, překlad, označení mluvčího a časová razítka pro každý segment
translated_video
MP4
Dabované video, pokud se rozhodnete vydat i mluvenou verzi
translated_audio
WAV
Přeložený mluvený komentář smíchaný s původní hudbou a zvukovými efekty
original_video
MP4
Původní soubor uložený pro referenci
Ovládání

Opravte řádek titulků a nechte znovu vytvořit jen tuto část

Titulky vycházejí z přepsaných úseků. Upravte text nebo načasování jednoho řádku, spusťte opětovné vytvoření a soubory s titulky i dabovaná verze se aktualizují současně. Účtují se upravené úseky, přičemž minimální délka jednoho spuštění je jedna minuta.

Úpravy po jednotlivých segmentech

Úpravy po jednotlivých segmentech
Každý projekt rozděluje přepis na samostatné části, takže špatné slovo nebo špatně načasovaný titulky lze opravit jediným požadavkem.
Získat přepis a jeho segmenty
Upravte zdrojový text a my jej znovu přeložíme
Upravte přímo přeložený text, abyste zachovali své vlastní slovní spojení
Upravit časová razítka, přidat segmenty, smazat segmenty
Přiřadit jiný hlas konkrétnímu mluvčímu

Slovníky pro odbornou terminologii

Slovníky pro odbornou terminologii
Přidejte slovník, aby se názvy značek a odborné termíny v titulcích do všech jazyků překládaly stejně, případně je nechte schválně v původním znění.

Jeden slovník pokrývá jeden jazykový pár a platí pro všechny regionální varianty daného cílového jazyka, takže jeden španělský slovník poslouží es-mx a es-es stejně tak. Záznamy projektu glossary_version, takže pozdější úpravy nikdy nepozorovaně nezmění již hotovou práci.
Vstup

Podporované formáty souborů

Nahrajte podporované video nebo zvukový záznam, případně použijte podporovaný odkaz na média. Vytvořte projekt pro každý cílový jazyk a stáhněte si soubory SRT a WebVTT.

Video

7 formátů
.mp4
.mov
.mkv
.avi
.webm
.m4v
.3gp

Zvuk

4 formáty
.mp3
.wav
.flac
.m4a

Metadata dříve, než cokoliv utratíte

Koncový bod pro média vrací délku, velikost souboru, video kodek, snímkovou frekvenci, rozlišení, zvukový kodek, vzorkovací frekvenci a rozložení kanálů. Soubor si můžete ověřit a předem odhadnout cenu, protože projekty se účtují podle minut videa.
Bezpečnost a dodržování předpisů

Zabezpečení a ochrana vašich videí

Společnost Brask Inc vlastní certifikaci SOC 2 Type II, funguje v souladu s nařízením GDPR a v Centru důvěry zveřejňuje aktuální stav zabezpečení pro vaše posouzení.

Certifikace

SOC 2 Type II
GDPR
Člen organizací CAI a C2PA

Šifrování

TLS 1.2 při přenosu
AES-256 v klidovém stavu
Klíče spravované přes SSE-S3
Obměna klíčů minimálně každých 12 měsíců

Váš obsah

Uzavřené prostředí AI
Nikdy se nepoužívá k trénování obecných modelů
Úplný export, žádné závazky

Přístup

SSO a SAML
Řízení přístupu na základě rolí
Přihlašovací údaje klienta OAuth 2.0

Podnik

Možnosti umístění dat
Vlastní smlouvy o úrovni služeb (SLA)
Vyhrazený správce účtu

Práva na hlas

Syntetické hlasy s právy k užívání
Klonování hlasu na základě souhlasu
Bezpečnostní opatření v oblasti umělé inteligence, zapojení člověka do procesu
Srovnání

Porovnání Rask API a vlastního řešení titulků

Titulky v jiném jazyce vyžadují přepis, překlad, načasování a export souborů. Tady je srovnání stejného výsledku vytvořeného dvěma způsoby.
Co budete potřebovat
Rask API
Sestaveno z dílů
Přepis s časovými značkami
Součástí balení
API pro převod řeči na text
Titulky v jiném jazyce
Více než 135 jazyků a regionálních možností
Překladové API a úprava načasování
Export ve formátech SRT a WebVTT
Oba formáty v každém projektu
Vlastní generátor souborů
Jednotná terminologie
Slovníky
Vlastní úpravy
Oprava jednoho řádku
Jeden požadavek na úpravu a nové vytvoření
Ruční úprava každého souboru
Dabovaná verze téhož videa
Zahrnuto v rámci stejného projektu
Poskytovatel převodu textu na řeč a vlastní mixování zvuku
Rychlostní limity
Žádné
Podle toho, co vyžadují vaši poskytovatelé
Titulky vložené přímo do videa
Ve webové aplikaci Rask, v rozhraní API zatím ne
Vlastní vykreslování videa
Písmo, velikost a vzhled
Nastavení v přehrávači videa
Nastavení v přehrávači videa
Často kladené otázky

API pro titulky: nejčastější dotazy

Nenašli jste, co hledáte? Obraťte se na obchodní oddělení.

Nabízí Rask API pro titulky?

Jaké formáty titulků API vrací?

Mohu získat titulky v původním jazyce?

Jaké jazyky jsou podporované?

Umí API vkládat titulky přímo do videa?

Mohu změnit písmo, velikost nebo vzhled titulků?

Obsahují titulky popis hudby a zvukových efektů?

Jsou mluvčí identifikováni?

Jak mohu opravit řádek titulků?

Jak dlouho jsou odkazy ke stažení platné?

Mohu použít vlastní titulky?

Jak se účtuje titulkova API?

Jak získám přístup k API a klíč?

Začněte dabovat během jednoho odpoledne

Vytvořte svůj první požadavek ještě dnes a ozvěte se nám, jakmile budete potřebovat množstevní podmínky nebo jazyk, který nikdo jiný nemá.