Notas de Video IA
Genera notas estructuradas a partir de URLs de video usando Baidu AI. Soporta tres formatos de nota.
Flujo de trabajo
- Crear tarea: Enviar URL del video → obtener ID de tarea
- Consultar estado: Preguntar a la tarea cada 3-5 segundos hasta que se complete
- Obtener resultados: Recuperar las notas generadas cuando el estado sea 10002
Códigos de estado
| Código | Estado | Acción |
|---|---|---|
| 10000 | En progreso | Continuar preguntando |
| 10002 | Completado | Devolver resultados |
| Otro | Falló | Mostrar error |
Tipos de nota
| Tipo | Descripción |
|---|---|
| 1 | Notas en documento |
| 2 | Notas esquematizadas |
| 3 | Notas de texto gráfico |
APIs
Crear tarea
Endpoint: POST /v2/tools/ai_note/task_create
Parámetros:
video_url(obligatorio): URL pública del video
Ejemplo:
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
Respuesta:
{
"task_id": "uuid-string"
}
Consultar tarea
Endpoint: GET /v2/tools/ai_note/query
Parámetros:
task_id(obligatorio): ID de tarea del endpoint de creación
Ejemplo:
python3 scripts/ai_notes_task_query.py "task-id-here"
Respuesta (Completado):
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents": ["Contenido de nota..."]
}
]
}
Estrategia de polling
Opción 1: Polling manual
- Crear tarea → almacenar
task_id - Consultar cada 3-5 segundos:
python3 scripts/ai_notes_task_query.py <task_id> - Mostrar actualizaciones de progreso:
- Estado 10000: Procesando...
- Estado 10002: Completado
- Detenerse después de 30-60 segundos (dependiendo de la duración del video)
Opción 2: Polling automático (Recomendado)
Usar el script de polling para actualizaciones automáticas de estado:
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
Ejemplos:
# Predeterminado: 20 intentos, intervalos de 3 segundos
python3 scripts/ai_notes_poll.py "task-id-here"
# Personalizado: 30 intentos, intervalos de 5 segundos
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
Salida:
- Muestra progreso en tiempo real:
[1/20] Procesando... 25% - Se detiene automáticamente cuando se completa
- Devuelve notas formateadas con etiquetas de tipo
Manejo de errores
- URL inválida: "La URL del video no es accesible"
- Error de procesamiento: "Error al analizar el video"
- Tiempo de espera agotado: "El video es demasiado largo, inténtalo de nuevo más tarde"