Transkrypcja wideo

Transkrypcja używa AI do wygenerowania ścieżki tekstowej z dźwięku wideo. Wygenerowana ścieżka tekstowa jest dodawana do wideo jako automatycznie utworzona ścieżka napisów i jest też dostępna jako transkrypcja w postaci zwykłego tekstu.

Funkcje AI wymagają planu z włączonymi funkcjami AI. Token API, którego używasz, musi mieć uprawnienie update.

Rozpoczęcie transkrypcji

Rozpocznij transkrypcję, wysyłając żądanie POST na endpoint /videos/:id/transcribe. Pole language informuje silnik transkrypcji, w jakim języku jest dźwięk.

CURL


curl -X POST https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"language": "en"}'

JavaScript / Node.js


const data = {
language: "en" // BCP-47 language tag, e.g. "en", "en-US", "de", "de-DE"
};
 
const response = await fetch('https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe', {
method: 'POST',
body: JSON.stringify(data),
headers: {
  'Authorization': 'Bearer YOUR_TOKEN',
  'Content-Type': 'application/json'
}
});
 
const result = await response.json();

PHP


$client = new GuzzleHttp\Client();
$data = [
"language" => "en" // BCP-47 language tag, e.g. "en", "en-US", "de", "de-DE"
];
 
$response = $client->request('POST', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);
 
$result = json_decode($response->getBody(), true);

Parametry

Field	Required	Description
`language`	Tak	Język dźwięku jako tag BCP-47 (`en`, `en-US`, `de`, `de-DE`, …).

Odpowiedź

Transkrypcja działa asynchronicznie. Żądanie zwraca natychmiast jeden lub więcej rekordów zadań transkrypcji. Wideo dłuższe niż 3 godziny są dzielone na wiele fragmentów, więc odpowiedź może zawierać więcej niż jeden wpis.


[
  {
    "id": string,
    "status": "QUEUED" | "IN_PROGRESS" | "COMPLETED" | "FAILED" | "NONE",
    "language": string,
    "jobName": string
  }
]

Gdy zadanie się zakończy, do wideo zostaje dodana automatycznie wygenerowana ścieżka tekstowa, a transkrypcja zostaje uzupełniona. Odpytuj endpoint pobierz wideo i odczytaj texttracks oraz transcriptions (lub autoTranscription), żeby pobrać wynik.

Automatyczna transkrypcja przy przesyłaniu

Transkrypcję możesz też uruchomić automatycznie zaraz po zakończeniu kodowania. Ustaw autoTranscribe: true i prawidłowy language podczas tworzenia wideo. Wymaga to uprawnienia create zamiast update.


{
  "title": "Your video title",
  "language": "en",
  "autoTranscribe": true
}