Aller au contenu principal

Comment utiliser l'API Vimeo AI

Cette fonctionnalité nécessite un forfait Entreprise.

Déclenchez des actions AI sur vos vidéos par programmation—transcrire, traduire, doubler et poser des questions via des points de terminaison REST API, sans utiliser l'interface web Vimeo.

Dans cet article :

Qui peut utiliser l'API Vimeo AI ?

L'API Vimeo AI est disponible uniquement pour les utilisateurs du forfait Entreprise. Contactez votre gestionnaire de compte si vous souhaitez passer à un niveau supérieur.

Actions disponibles

L'API prend en charge quatre actions sous /videos/{id}/ai/*:

  • Transcription — Générer une transcription à partir de l'audio de votre vidéo
  • Traduction des sous-titres — Traduire les sous-titres dans les langues prises en charge
  • Doublage audio — Doubler l'audio de votre vidéo dans une autre langue
  • AskAI — Posez des questions sur le contenu de votre vidéo et obtenez des réponses générées par l'IA

Il y a neuf points de terminaison au total : POST et GET pour chaque action, plus un point de terminaison GET pour les langues prises en charge.

Comment cela fonctionne

Tous les appels de l'API AI sont asynchrones :

  1. Envoyez une demande POST pour démarrer un travail (par ex., /videos/{id}/ai/transcription)
  2. Interrogez l'état avec une demande GET au même point de terminaison
  3. Lorsque le travail se termine, votre résultat est prêt

Chaque appel cible une seule vidéo. Il n'y a pas de point de terminaison en masse — pour traiter plusieurs vidéos, parcourez-les individuellement.

Authentification : la portée OAuth ai

Pour appeler les points de terminaison de l'API AI, votre jeton a besoin de la nouvelle portée ai. Vous pouvez l'ajouter lors de la génération d'un jeton d'accès personnel—aucune mise en service ou configuration manuelle requise.

Crédits AI

Les demandes d'API consomment du même pool de crédits AI que l'interface web Vimeo, aux mêmes taux. Par exemple, la traduction des sous-titres coûte toujours 10 crédits par minute de vidéo par langue. Consultez Taux et politiques des crédits AI pour plus de détails.

Limites de débit

Chaque point de terminaison de l'API AI est limité à 10 demandes par minute (~600 vidéos par heure). Si vous avez besoin d'une limite supérieure, votre gestionnaire de compte peut l'ajuster pour votre compte.

Documentation API

Les spécifications complètes des points de terminaison, les formats de demande/réponse et les exemples sont sur developer.vimeo.com/api/reference/videos#ai.

Étapes suivantes suggérées

Articles associés