nguyentrunghieutcu/videodb

Que fait videodb ?

Voir, comprendre et agir sur la vidéo et l'audio. Voir - ingérer depuis des fichiers locaux, URLs, flux RTSP/en direct, ou enregistrement d'écran ; retourne un contexte en temps réel et des liens de flux lisibles. Comprendre - extraire des images, construire des index visuels/sémantiques/temporels, et rechercher des moments avec horodatages et clips automatiques. Agir - transcoder et normaliser (codec, fps, résolution, rapport hauteur/largeur), effectuer des montages sur la timeline (sous-titres, superpositions de texte/image, branding, superpositions audio, doublage, traduction), générer des ressources média (image, audio, vidéo) et bien plus encore.

Utilisation

Cet outil utilise une API REST, l'URL de base est https://api.videodb.io. Vous avez besoin d'une clé API (VIDEODB_API_KEY), insérez-la dans votre fichier .env ou définissez-la comme variable d'environnement.

VIDEODB_API_KEY=votre_cle_api_ici

Outils

Il y a un seul outil videodb qui gère tous les types d'actions (ingérer, comprendre, agir) avec un paramètre action.

Paramètres de l'outil

• action : L'action que vous souhaitez effectuer (chaîne de caractères). Les valeurs possibles : ingest, search, transcode, generate_timeline, generate_media, get_collection, list_collections, delete_collection, get_project, list_projects, delete_project.
• params : Paramètres JSON pour l'action (objet JSON). La structure de chaque action est décrite ci-dessous.

Actions et leurs paramètres

Ingest

Ingérer un fichier vidéo/audio depuis une URL, un fichier local, un flux RTSP/en direct, ou un enregistrement d'écran.

{
  "action": "ingest",
  "params": {
    "url": "https://example.com/video.mp4",
    "collection_id": "votre_id_de_collection_optionnel",
    "name": "nom_optionnel_de_la_video"
  }
}

Search

Rechercher des moments dans une vidéo indexée avec des horodatages.

{
  "action": "search",
  "params": {
    "video_id": "votre_id_video",
    "query": "votre_requete_de_recherche",
    "type": "semantic"
  }
}

Transcode

Transcoder une vidéo dans un format/codec/résolution spécifique.

{
  "action": "transcode",
  "params": {
    "video_id": "votre_id_video",
    "codec": "h264",
    "resolution": "1080p",
    "fps": 30,
    "aspect_ratio": "16:9"
  }
}

Generate Timeline

Créer une timeline de montage avec des clips, sous-titres, superpositions, etc.

{
  "action": "generate_timeline",
  "params": {
    "video_id": "votre_id_video",
    "operations": [
      {
        "type": "subtitle",
        "text": "Bonjour le monde",
        "start": 0,
        "end": 5
      },
      {
        "type": "overlay",
        "image_url": "https://example.com/logo.png",
        "position": "top-right",
        "start": 0,
        "end": 10
      }
    ],
    "output_format": "mp4"
  }
}

Generate Media

Générer une ressource média (image, extrait audio, GIF) à partir d'une vidéo.

{
  "action": "generate_media",
  "params": {
    "video_id": "votre_id_video",
    "type": "thumbnail",
    "timestamp": 5
  }
}

Aide

Pour plus d'informations sur les paramètres d'API, visitez la documentation VideoDB : https://docs.videodb.io