API de Clipes
A API de Clipes trabalha com os clipes individuais que um projeto de IA produziu. Cada clipe pertence a um projeto e é acessível pelo seu próprio id. Use esses endpoints para inspecionar um clipe, enviar feedback de curtir ou descurtir (que alimenta o ranqueamento por IA da VDClip), renderizar um clipe em um vídeo finalizado e publicá-lo nas suas contas sociais conectadas.
A renderização é assíncrona: inicie uma renderização com um POST e depois consulte o status da última renderização até que ela atinja um estado terminal.
Convenções
As requisições usam a URL base https://api.vdclip.com com o cabeçalho Authorization: Bearer vdck_.... A API é apenas servidor para servidor e não tem CORS.
Respostas bem-sucedidas retornam o recurso diretamente. Erros retornam um array errors. Ler um clipe requer o escopo vdclip:results:read; o feedback de curtir ou descurtir requer vdclip:results:write. Um escopo ausente retorna MISSING_SCOPE.
Renderizar requer o escopo vdclip:render:execute e publicar requer vdclip:social:publish. Ambos são restritos por plano, e a renderização também consome créditos. Faça um POST de renderização e depois consulte renders/latest até que o status seja terminal antes de publicar. Se o seu plano não tiver o recurso, você recebe MISSING_SCOPE; se estiver sem créditos, recebe INSUFFICIENT_CREDITS. Consulte a página de preços para ver o que cada plano inclui.
Endpoints
Curtir um clipe
POST /v1/clips/{clip_id}/like
Descurtir um clipe
POST /v1/clips/{clip_id}/dislike
Iniciar uma renderização
POST /v1/clips/{clip_id}/renders
Obter o status da última renderização
GET /v1/clips/{clip_id}/renders/latest
Publicar ou agendar um clipe
POST /v1/clips/{clip_id}/publish