API Video Transcription

Soumettez une vidéo ou un fichier audio et recevez une transcription mot à mot avec identification du locuteur. L'API prend en charge les vidéos des principales plateformes et les fichiers vidéo/audio téléversés localement, avec des paramètres de langue.

Sources Vidéo Prises en Charge

L'API accepte les URLs des plateformes suivantes : YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble et plus encore.

Vous pouvez également téléverser des fichiers vidéo ou audio localement. Le téléversement local nécessite un abonnement Standard ou supérieur. Consultez l'API Upload pour plus de détails.

Flux de Travail

Soumettez une tâche de transcription depuis une URL de vidéo
Interrogez les résultats jusqu'à ce que le statut soit SUCCEEDED

Soumettre une Tâche de Transcription

Soumettez une nouvelle tâche de transcription depuis une URL de vidéo ou audio.

POST https://wayinvideo-api.wayin.ai/api/v2/transcripts

Corps de la Requête

Paramètre	Type	Obligatoire	Défaut	Description
`video_url`	string	Oui	—	L'URL de la vidéo/audio source ou l'identifiant du fichier téléversé
`source_lang`	string	Non	`null`	Langue source de la vidéo (voir Langues prises en charge). Si `null`, le système détecte automatiquement la langue d'origine.
`target_lang`	string	Non	`null`	Langue cible pour la transcription (voir Langues prises en charge). Si `null`, aucune traduction n'est appliquée. Si `target_lang` diffère de la langue d'origine de la vidéo, la transcription sera automatiquement traduite dans la langue cible.

Exemple de Requête

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/transcripts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "target_lang": "en"
  }'

Réponse

{
  "data": {
    "id": "trans_proj_001",
    "name": "sample project name",
    "status": "CREATED"
  }
}

Champ	Type	Description
`id`	string	Identifiant de la tâche (utilisé pour récupérer les résultats)
`name`	string	Nom de la tâche
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`

Récupérer les Résultats de Transcription

Récupérez la transcription avec les horodatages mot à mot et les étiquettes de locuteur. Interrogez jusqu'à ce que status soit SUCCEEDED.

GET https://wayinvideo-api.wayin.ai/api/v2/transcripts/results/{id}

Paramètres de Chemin

Paramètre	Type	Obligatoire	Description
`id`	string	Oui	L'ID de tâche retourné par l'endpoint de soumission

Exemple de Requête

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/transcripts/results/trans_proj_001 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Réponse

{
  "data": {
    "status": "SUCCEEDED",
    "cost_usage": 27.0,
    "transcript": [
      {
        "text": "Welcome to today's presentation",
        "language": null,
        "start": 200,
        "end": 4500,
        "speaker": "Speaker 1"
      },
      {
        "text": "Thanks for coming",
        "language": null,
        "start": 5000,
        "end": 8200,
        "speaker": "Speaker 2"
      }
    ]
  }
}

Champs de la Réponse

Champ	Type	Description
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`
`error_message`	string	Raison de l'erreur (présent uniquement quand `status` est `FAILED`)
`cost_usage`	number	Crédits API consommés pour cette requête
`transcript`	array	Liste des segments de transcription (voir ci-dessous)

Segment de Transcription

Champ	Type	Description
`text`	string	Texte transcrit
`language`	string \| null	Code de langue détecté, ou `null` si non détecté
`start`	integer	Temps de début en millisecondes
`end`	integer	Temps de fin en millisecondes
`speaker`	string	Étiquette du locuteur (ex. `"Speaker 1"`)