VocalStack Logo

Documentation

Obtenir des données de transcription

Transcrire à partir d'un microphone ou d'un LiveStream

Transcrire le discours en direct à partir d'un microphone ou d'un flux en direct

Sessions de transcription

Surveiller et gérer l'état de la transcription avec des sessions

Traduire une transcription

Traduire le texte transcrit dans une autre langue

Transcription audio à partir d'URL

Transcrire la parole d'un audio préenregistré dans une URL en texte brut

Jetons d'authentification côté client

Créer un jeton d'authentification temporaire pour les requêtes côté client

Demande de transcription et réponse

Options et réponses de requête communes pour toutes les opérations de transcription

Transcrire et présenter une session polyglotte

Créer une session pouvant être utilisée pour diffuser une transcription en direct via un lien public partageable

Obtenir des données de transcription

Parcourir la documentation
Obtenez des données à partir de transcriptions en attente ou terminées. Cela inclut la chronologie de la transcription, les mots clés, le résumé et les segments de paragraphe.
Obtenir toutes les transcriptions
Transcription audio à partir d'URL
Transcrire la parole d'un audio préenregistré dans une URL en texte brut. Les principaux formats de fichiers sont pris en charge, y compris MP3, WAV, FLAC et OGG.
Transcrire à partir d'un microphone ou d'un LiveStream
Transcrire le discours en direct à partir d'un microphone ou d'un flux en direct. Intégrez Polyglot pour créer un lien public partageable pour la transcription que les utilisateurs peuvent lire dans n'importe quelle langue.
Transcrire et présenter une session polyglotte
Créer une session pouvant être utilisée pour diffuser une transcription en direct via un lien public partageable. Les utilisateurs peuvent lire les transcriptions en direct dans leur langue préférée, et même les transcriptions passées lorsque votre session est inactive.

L'obtention de toutes les transcriptions est réalisée en utilisant

du SDK VocalStack:TranscriptionsObtenir une transcription unique
JavaScript
import { Transcriptions } from '@vocalstack/js-sdk';

const sdk = new Transcriptions({ apiKey: 'YOUR-API-KEY' });
const transcriptions = await sdk.getAllTranscriptions();

transcriptions.data?.forEach((transcription) => {
  // the transcription ID (use this to get more details about the transcription)
  console.log(transcription.id);
  
  // 'waiting', 'processing', 'done', or 'error'
  console.log(transcription.status);

  // the time the transcription started
  console.log(transcription.start);

  // the time the transcription finalized
  console.log(transcription.end); 

  // the keywords associated with the transcription
  console.log(transcription.keywords);
  
  // the length of the transcription in seconds
  console.log(transcription.duration);
});

Pour obtenir toutes les données disponibles pour une transcription, nous devons utiliser le.

de cette transcription. Le id est retourné chaque fois qu'un processus de transcription est initié. Cependant, il peut également être obtenu en regardant toutes les transcriptions en utilisant l'API ci-dessus. idPour obtenir une transcription spécifique, utilisez
du SDK VocalStack:TranscriptionsTranscriptions en attente
JavaScript
import { Transcriptions } from '@vocalstack/js-sdk';

const sdk = new Transcriptions({ apiKey: 'YOUR-API-KEY' });
const transcription = await sdk.getTranscription({ id: 'TRANSCRIPTION-ID' });
const data = transcription.data;

if (data) {
  // the transcription ID (use this to get more details about the transcription)
  console.log(data.id);

  // 'waiting', 'processing', 'done', or 'error'
  console.log(data.status);

  // the time the transcription started
  console.log(data.start);

  // the time the transcription finalized
  console.log(data.end);

  // the keywords associated with the transcription
  console.log(data.keywords);

  // the length of the transcription in seconds
  console.log(data.duration);

  // an object with the transcription timeline
  console.log(data.timeline);

  // a summary of the transcription
  console.log(data.summary);

  // the entire transcription in paragraph form
  console.log(data.paragraphs);
}

Dans la plupart des cas, vous ne serez intéressé à obtenir des données pour une transcription unique qu'une fois que cette transcription aura terminé son traitement. En effet, les transcriptions sont des opérations asynchrones qui peuvent être surveillées de manière asynchrone à l'endroit où vous exécutez le processus de transcription. Toutefois, si vous demandez des données de transcription pour une transcription qui est encore en attente, vous obtiendrez toujours toutes les données disponibles pour cette transcription, y compris les données les plus récentes.

VocalStack SDK-st:timeline.

Transcriptions complétées

Une fois la transcription terminée, elle a subi un post-traitement, et dans ce cas les données de transcription contiendront également des valeurs pour keywords, summary et paragraphs.

Les prochaines étapes

Examinez l'objet de réponse retourné avec chaque transcription:
Demande de transcription et réponse
Options et réponses de requête communes pour toutes les opérations de transcription. Utilisez les options pour configurer les paramètres de transcription.
Scroll Up