Vídeo

Criar uma tarefa

Um pedido de vídeo inclui normalmente prompt, model e propriedades dos fotogramas, como duração, proporção, resolução ou referências, apenas quando o modelo escolhido as suportar.

Guarde imediatamente o ID da tarefa. É necessário para mostrar o progresso, permitir o cancelamento na interface e obter o conteúdo final.

curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Consultar o estado

• Leia uma tarefa através de GET /videos/{video_id}.
• Considere o estado terminal como a fonte de verdade para a conclusão.
• Use um intervalo de consulta crescente e interrompa-o quando o utilizador sair.

Trabalhar com o resultado

Após a conclusão, use o URL ou conteúdo devolvido pela tarefa e verifique se o ficheiro está pronto antes de mostrar um leitor.

Conserve o pedido, o modelo, os parâmetros e o ID da tarefa para apoio, mas não guarde referências de entrada além do necessário para o produto.