Transcrire une vidéo

La transcription utilise l’IA pour générer une piste de texte à partir de l’audio d’une vidéo. La piste de texte générée est ajoutée à la vidéo comme piste de sous-titres auto-générée et est aussi disponible sous forme de transcription en texte brut.

Les fonctions IA nécessitent un plan avec les fonctions IA activées. Le token API que tu utilises doit avoir la permission update.

Démarrer une transcription

Démarre une transcription en envoyant une requête POST à l’endpoint /videos/:id/transcribe. Le champ language indique au moteur de transcription dans quelle langue est l’audio.

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);

Paramètres

Field	Required	Description
`language`	Oui	Langue de l’audio sous forme de tag BCP-47 (`en`, `en-US`, `de`, `de-DE`, …).

Réponse

La transcription s’exécute de façon asynchrone. La requête répond immédiatement avec un ou plusieurs enregistrements de jobs de transcription. Les vidéos de plus de 3 heures sont découpées en plusieurs morceaux, la réponse peut donc contenir plus d’une entrée.


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

Lorsqu’un job se termine, une piste de texte auto-générée est ajoutée à la vidéo et la transcription est renseignée. Interroge l’endpoint obtenir vidéo et lis texttracks et transcriptions (ou autoTranscription) pour récupérer le résultat.

Transcrire automatiquement à l’upload

Tu peux aussi démarrer la transcription automatiquement une fois l’encodage terminé. Définis autoTranscribe: true et un language valide lorsque tu crées une vidéo. Cela nécessite la permission create au lieu de update.


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