Anotações de Vídeo com IA
Gere anotações estruturadas a partir de URLs de vídeo usando a IA da Baidu. Suporta três formatos de anotações.
Fluxo de Trabalho
- Criar Tarefa: Envie a URL do vídeo → receba um ID de tarefa
- Consultar Status: Consulte a tarefa a cada 3-5 segundos até a conclusão
- Obter Resultados: Recupere as anotações geradas quando o status = 10002
Códigos de Status
| Código | Status | Ação |
|---|---|---|
| 10000 | Em andamento | Continuar consultando |
| 10002 | Concluído | Retornar resultados |
| Outro | Falha | Exibir erro |
Tipos de Anotação
| Tipo | Descrição |
|---|---|
| 1 | Anotações em documento |
| 2 | Anotações em esboço |
| 3 | Anotações gráfico-texto |
APIs
Criar Tarefa
Endpoint: POST /v2/tools/ai_note/task_create
Parâmetros:
video_url(obrigatório): URL pública do vídeo
Exemplo:
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
Resposta:
{
"task_id": "uuid-string"
}
Consultar Tarefa
Endpoint: GET /v2/tools/ai_note/query
Parâmetros:
task_id(obrigatório): ID da tarefa do endpoint de criação
Exemplo:
python3 scripts/ai_notes_task_query.py "task-id-here"
Resposta (Concluída):
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents": ["Conteúdo da anotação..."]
}
]
}
Estratégia de Polling
Opção 1: Polling Manual
- Crie a tarefa → armazene o
task_id - Consulte a cada 3-5 segundos:
python3 scripts/ai_notes_task_query.py <task_id> - Mostre atualizações de progresso:
- Status 10000: Processando...
- Status 10002: Concluído
- Pare após 30-60 segundos (dependendo da duração do vídeo)
Opção 2: Polling Automático (Recomendado)
Use o script de polling para atualizações automáticas de status:
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
Exemplos:
# Padrão: 20 tentativas, intervalos de 3 segundos
python3 scripts/ai_notes_poll.py "task-id-here"
# Personalizado: 30 tentativas, intervalos de 5 segundos
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
Saída:
- Mostra progresso em tempo real:
[1/20] Processando... 25% - Para automaticamente quando concluído
- Retorna anotações formatadas com rótulos de tipo
Tratamento de Erros
- URL inválida: "URL do vídeo não acessível"
- Erro de processamento: "Falha ao analisar o vídeo"
- Tempo limite: "Vídeo muito longo, tente novamente mais tarde"