Enviando um vídeo para clipagem

Antes de gerar clipes, você precisa de um video_id. Há duas formas de obter um, e ambas convergem para o mesmo passo seguinte: chamar POST /clips com esse video_id (veja o Quickstart).

O vídeo precisa ter no mínimo 1 minuto. A duração máxima depende do seu plano.

Opção A: por URL pública

A forma mais simples. Envie a URL de um vídeo público (YouTube, TikTok, Twitch, Kick, Vimeo, etc.) para análise. Analisar não custa créditos.

curl -X POST https://api.cut.pro/api/v1/clips/info \
  -H "X-Api-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.youtube.com/watch?v=..." }'

A resposta traz video_id, credits_cost (o que será cobrado ao submeter), current_balance e o título/duração do vídeo. Guarde o video_id e siga para POST /clips.

Opção B: enviando seu próprio arquivo

Para vídeos do seu computador, o envio é feito em três passos com uma URL pré-assinada (presigned), enviando os bytes direto para o armazenamento.

Limites do upload: máximo 2 GB e extensões .mp4, .mov, .webm, .mkv. A URL pré-assinada expira em 1 hora.

Inicie o upload

Declare o nome do arquivo e o tipo de conteúdo. A resposta traz o video_id, a upload_url (para onde enviar os bytes) e expires_in (segundos até expirar).

curl -X POST https://api.cut.pro/api/v1/videos/upload \
  -H "X-Api-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "minha-live.mp4",
    "content_type": "video/mp4"
  }'

Envie os bytes para a upload_url

Faça um PUT do arquivo direto na upload_url. Não envie a sua chave de API aqui (a URL já é assinada), e use o mesmo Content-Type que você declarou no passo anterior.

curl -X PUT "UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @minha-live.mp4

O PUT deve retornar 200 antes de seguir.

Finalize o upload

Registre o upload informando as dimensões e a duração do arquivo (medidas no seu lado). A resposta traz a metadata do vídeo e o credits_cost, igual à análise por URL.

curl -X POST https://api.cut.pro/api/v1/videos/upload/complete \
  -H "X-Api-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "VIDEO_ID",
    "file_name": "minha-live.mp4",
    "duration": 5400,
    "width": 1920,
    "height": 1080
  }'

Chame este passo apenas depois que o PUT retornar 200. Se o arquivo não estiver no armazenamento, a resposta é 404 FILE_NOT_FOUND. Se a duração estiver fora dos limites, retorna 400 VIDEO_TOO_SHORT ou VIDEO_TOO_LONG (com max_duration).

Próximo passo

Com o video_id em mãos (de qualquer uma das opções), submeta para clipagem:

Continue no Quickstart a partir do passo “Envie para clipagem” (POST /clips).

Documentation Index

​Opção A: por URL pública

​Opção B: enviando seu próprio arquivo

​Próximo passo

Opção A: por URL pública

Opção B: enviando seu próprio arquivo

Próximo passo