Notes Vidéo AI
Génère des notes structurées à partir d'URLs de vidéos en utilisant l'IA Baidu. Trois formats de notes sont disponibles.
Workflow
- Créer une tâche : Soumettre une URL de vidéo → obtenir un ID de tâche
- Interroger le statut : Interroger la tâche toutes les 3 à 5 secondes jusqu'à terminaison
- Récupérer les résultats : Obtenir les notes générées lorsque le statut = 10002
Codes de Statut
| Code | Statut | Action |
|---|---|---|
| 10000 | En cours | Continuer l'interrogation |
| 10002 | Terminé | Retourner les résultats |
| Autre | Échec | Afficher l'erreur |
Types de Notes
| Type | Description |
|---|---|
| 1 | Notes document |
| 2 | Notes plan |
| 3 | Notes texte graphique |
APIs
Créer une Tâche
Endpoint : POST /v2/tools/ai_note/task_create
Paramètres :
video_url(obligatoire) : URL publique de la vidéo
Exemple :
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
Réponse :
{
"task_id": "uuid-string"
}
Interroger une Tâche
Endpoint : GET /v2/tools/ai_note/query
Paramètres :
task_id(obligatoire) : ID de la tâche provenant de l'endpoint de création
Exemple :
python3 scripts/ai_notes_task_query.py "task-id-here"
Réponse (Terminée) :
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents: ["Contenu de la note..."]
}
]
}
Stratégie d'Interrogation
Option 1 : Interrogation Manuelle
- Créer une tâche → stocker
task_id - Interroger toutes les 3 à 5 secondes :
python3 scripts/ai_notes_task_query.py <task_id> - Afficher les mises à jour de progression :
- Statut 10000 : Traitement en cours...
- Statut 10002 : Terminé
- Arrêter après 30 à 60 secondes (selon la durée de la vidéo)
Option 2 : Interrogation Automatique (Recommandée)
Utilisez le script d'interrogation pour des mises à jour automatiques du statut :
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
Exemples :
# Par défaut : 20 tentatives, intervalles de 3 secondes
python3 scripts/ai_notes_poll.py "task-id-here"
# Personnalisé : 30 tentatives, intervalles de 5 secondes
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
Sortie :
- Affiche la progression en temps réel :
[1/20] Traitement en cours... 25% - S'arrête automatiquement une fois terminé
- Renvoie les notes formatées avec les étiquettes de type
Gestion des Erreurs
- URL invalide : "L'URL de la vidéo n'est pas accessible"
- Erreur de traitement : "Échec de l'analyse de la vidéo"
- Délai d'attente dépassé : "Vidéo trop longue, réessayez plus tard"