ClipReel para Agentes

Automatize a edição de vídeo com agentes de IA

Use a API REST do ClipReel para automatizar demonstrações de produtos, cortes para redes sociais, legendas e edições revisáveis com trabalhos de renderização duráveis.

Conectar um agente

Teste a edição em filmagens reais

Compare o clipe original de oito segundos e a edição de seis segundos. Abra o projeto de exemplo com a solicitação pronta para envio.

Corte os primeiros dois segundos, adicione o título “Um dia na crista” por três segundos, aplique um tratamento de cor mais frio e finalize com um fade out no meio segundo final.
Testar no ClipReel Baixar clipe original
Gravação original
Cortar, titular e aplicar fade

Conectar ao ClipReel

Crie um token com escopo, salve-o como CLIPREEL_API_TOKEN, e configure seu cliente. Use um token de leitura de projeto, escrita de projeto e trabalho para o passo a passo.

curl https://www.clipreel.com/api/v1/projects \
  -H "Authorization: Bearer $CLIPREEL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product walkthrough"}'

Automatize uma demonstração de produto em etapas

Crie um projeto para cada lançamento e importe as gravações de tela originais. Coloque edit_by_prompt na fila com uma abertura clara, uma duração alvo e requisitos de legendas. Envie uma chave de idempotência para cada tarefa para que uma nova tentativa possa recuperar o resultado original.

Crie versões para redes sociais a partir da edição aprovada

Fixe a mesma revisão salva em cada solicitação export_video e envie uma chave distinta para 16:9, 9:16 ou quadrado. Verifique o status no recurso da tarefa. Use o link de edição para abrir as mesmas filmagens, cortes, legendas e efeitos antes de solicitar outra exportação.

Trate erros e permissões na sua integração

Use tokens de conta com escopo definido e faça o upload diretamente para a URL assinada. Verifique as assinaturas de callback em relação ao corpo da solicitação bruta antes de ler a conclusão. Use o ID estável da tarefa para lidar com novas tentativas. Para um aplicativo parceiro, crie uma sessão incorporada com escopo definido para sua origem e projeto exatos.

Fluxos de trabalho REST

Envie JSON com Authorization: Bearer $CLIPREEL_API_TOKEN. Para uma importação de arquivo, envie o nome do arquivo declarado, tipo de mídia, tamanho em bytes e duração para POST /tools/import_media. Faça o upload do arquivo com o mesmo tipo de conteúdo e tamanho para a URL retornada.

Rascunhe um corte de lançamento

POST https://www.clipreel.com/api/v1/tools/edit_by_prompt
{
  "projectId": "PROJECT_ID",
  "prompt": "Remove pauses, add captions, and cut a 45-second launch video",
  "idempotencyKey": "launch-v1-edit"
}

Gere ou importe indicações de legendas

Coloque na fila POST /tools/transcribe_video com o ID do projeto. Em seguida, verifique GET /jobs/JOB_ID. Passe o retornado result.cues to POST /tools/add_captions com um estilo como white or lime. Use o mesmo objeto de indicação para marcas de tempo que você mesmo fornecer.

Exporte um corte vertical

POST https://www.clipreel.com/api/v1/tools/export_video
{
  "projectId": "PROJECT_ID", "revision": 7,
  "aspect": "9:16", "resolution": "720p",
  "idempotencyKey": "launch-v1-vertical", "webhookId": "WEBHOOK_ID"
}

Verifique callbacks assinados

Registre seu endpoint HTTPS em POST /webhooks com {"url":"https://partner.example.com/clipreel"}. Armazene o segredo de assinatura retornado. Calcule HMAC-SHA256 sobre o timestamp Unix, um ponto e o corpo da solicitação bruta. Compare em tempo constante com v1 no cabeçalho ClipReel-Signature . Rejeite timestamps com mais de cinco minutos. Trate ClipReel-Delivery como o ID de desduplicação. Verifique links de mídia assinados atualizados.

Incorpore o mesmo projeto editável

POST https://www.clipreel.com/api/v1/embed-sessions
{
  "projectId": "PROJECT_ID",
  "origin": "https://partner.example.com",
  "permission": "edit"
}

Carregue embedUrl em um iframe na origem registrada. As sessões duram 20 minutos e herdam as permissões do token. Defina permission to view para uma sessão somente de revisão. Abrir no ClipReel leva o editor de volta ao projeto privado na área de trabalho completa.

Configuração de cliente e fluxos de trabalho

Edição de vídeo no Claude Code

Peça ao Claude Code para transformar gravações em um corte editável. Revise uma prévia e abra o mesmo projeto no ClipReel.

Configuração do Claude Code
Corte os primeiros dois segundos.

Servidor MCP de edição de vídeo

Conecte um cliente MCP ao ClipReel para criar projetos, propor edições na linha do tempo, revisar prévias e exportar cortes editáveis.

Configuração de MCP

Edite vídeos de produtos a partir do Cursor

Use o Cursor e o ClipReel para transformar gravações de demonstração de produtos em um vídeo editável com legendas e múltiplos formatos de exportação.

Fluxo de trabalho no Cursor

Automatize a edição de vídeo com agentes de IA

Use a API REST do ClipReel para automatizar demonstrações de produtos, cortes para redes sociais, legendas e edições revisáveis com trabalhos de renderização duráveis.

Guia da API REST

Trabalhos hospedados utilizam seu plano ClipReel. Veja edições de chat e créditos de vídeo por plano.