API Find Moments

API Find Moments

L'API Find Moments vous permet de décrire les moments souhaités en langage naturel — comme "réactions drôles" ou "démonstrations de produits" — et l'API trouve et extrait les clips correspondants avec horodatages, titres, descriptions et hashtags depuis des vidéos de toutes durées, y compris des contenus de plusieurs heures. Si l'export est activé, la réponse inclut également des liens de téléchargement des vidéos rendues pour chaque clip, avec un recadrage automatique optionnel qui maintient le sujet principal centré et des overlays de sous-titres animés pour des sorties plus engageantes.

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 utiliser des fichiers téléversés localement. Le téléversement local nécessite un abonnement Standard ou supérieur. Consultez l'API Upload pour plus de détails.

Soumettre une Tâche Find Moments

POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments

Corps de la Requête

Lors du rendu des clips, vous pouvez activer des fonctionnalités telles que les Sous-titres Animés, l'AI Reframe et des overlays de texte AI Hook optionnels. Avec l'AI Reframe, le système détecte le sujet principal dans le cadre, le maintient centré, optimise le recadrage selon le format choisi et sélectionne la mise en page la plus adaptée selon la structure de la scène. Ces fonctionnalités sont contrôlées par des paramètres dont les noms commencent par enable_ (voir le tableau ci-dessous).

Valeurs de mise en page Reframe

Les valeurs reframe_layout autorisées dépendent du ratio. Auto est toujours autorisé (par défaut) ; omettre le champ ou passer une chaîne vide a le même comportement. Passez les noms de mise en page exactement comme indiqué ci-dessous (sensible à la casse et aux espaces).

Comportement de enable_export

• Si enable_export est vide ou false, l'API retourne uniquement les plages temporelles des clips, titres, descriptions et métadonnées associées. Aucun rendu n'est effectué et il n'y a pas de liens d'export dans le résultat. Les paramètres ratio, reframe_layout, resolution, caption_display, enable_caption, cc_style_tpl, enable_ai_hook, ai_hook_script_style, ai_hook_position et enable_ai_reframe n'ont aucun effet lors de la création de la tâche. Vous pouvez ultérieurement rendre les clips sélectionnés via l'endpoint Ré-exporter des clips existants.
• Si enable_export est true, ces paramètres prennent effet, chaque clip est rendu immédiatement, et le résultat inclut un lien de téléchargement pour chaque clip. Le traitement peut être plus long car chaque clip est rendu.

Le corps de la requête définit enable_export à true. Les clips sont rendus ; chaque clip inclut un export_link.

Requête

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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",
    "query": "sample query",
    "project_name": "sample project name",
    "enable_export": true,
    "resolution": "FHD_1080",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Réponse de soumission

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

Le corps de la requête omet enable_export ou le définit à false. Seules les plages temporelles, titres, descriptions et tags des clips sont retournés ; pas de rendu, pas de liens d'export.

Requête

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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",
    "query": "sample query",
    "project_name": "sample project name"
  }'

Réponse de soumission

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

Récupérer les Résultats Find Moments

Interrogez pour obtenir les résultats jusqu'à ce que status soit SUCCEEDED.

Résultats incrémentiels : Lorsque status est ONGOING, chaque appel retourne les clips générés jusqu'à présent — vous pouvez commencer à traiter les résultats partiels immédiatement. Lorsque status passe à SUCCEEDED, la réponse contient l'ensemble complet des clips.

GET https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments/results/{id}

Paramètres de Chemin

Exemple de Requête

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments/results/proj_moment_456 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Lorsque la tâche a été soumise avec enable_export: true, chaque clip inclut un export_link pour la vidéo rendue :

{
  "data": {
    "id": "proj_moment_789",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "expire_at": 1775831883112,
    "cost_usage": 120.0,
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": 120000,
        "end_ms": 185000,
        "thumbnail": "https://cdn.example.com/thumb/moment_001.jpg",
        "tags": ["product", "announcement"],
        "desc": "sample description",
        "score": 81,
        "export_link": "https://cdn.example.com/export/moment_001.mp4"
      }
    ]
  }
}

Lorsque la tâche a été soumise sans enable_export (ou avec enable_export: false), les clips n'incluent pas export_link :

{
  "data": {
    "id": "proj_moment_456",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "expire_at": 1775831883112,
    "cost_usage": 120.0,
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": 120000,
        "end_ms": 185000,
        "thumbnail": "https://cdn.example.com/thumb/moment_001.jpg",
        "tags": ["product", "announcement"],
        "desc": "sample description",
        "score": 81
      }
    ]
  }
}

Champs de la Réponse

Objet Clip

Ré-exporter des Clips Existants

Si vous souhaitez rendre des clips ultérieurement ou les ré-exporter avec un style de sous-titres différent, un format d'image, un AI Hook, des overlays ou d'autres paramètres d'export, utilisez l'API Clips Export.

Pour les projets Find Moments, passez l'id de tâche retourné par POST /api/v2/clips/find-moments comme project_id dans la requête d'export.