✦ API do Desenvolvedor

O API de recorte de vídeo

Transformar vídeos longos em clipes verticais legendados programáticamente. Preços transparentes por minuto — sem créditos, sem chamada de venda oculta.

clip.video expõe uma API HTTP simples para recorte, transcrição, legenda e conversões de utilidade. Inclua-a no seu próprio produto, automatize um conteúdo de pipeline ou clipe em escala. A API completa (com API-key auth + uma taxa publicada por minuto) está disponível na Plano de estudio; os endpoints abaixo de energia do aplicativo hoje.

Autenticação

As chaves de estúdio autenticam-se com um cabeçalho de portador. Manter o seu lado do servidor de chaves.

Authorization: Bearer sk_live_your_api_key

1 · Criar um trabalho de clipe

Envie um arquivo ou passe um URL de vídeo. mode seleciona a operação: clip (cortes de classificação), captions (capta-lo todo), ou transcribe (só transcrição).

# by URL
curl -X POST https://clip.video/api/upload/ \
  -F "url=https://example.com/podcast.mp4" \
  -F "mode=clip" \
  -F "style=hormozi" \
  -F "reframe=auto"

# by file
curl -X POST https://clip.video/api/upload/ \
  -F "file=@episode.mp4" -F "mode=clip"

Resposta:

{ "error": false, "job_id": "c45de43d67d4...", "redirect": "/v/c45de43d67d4.../" }

2 · Estado do trabalho da pesquisa

O gasoduto é assincrônico. done é verdade; clipes completados chegam na clips array com um download output URL.

curl https://clip.video/api/status/<job_id>/
{
  "status": "completed",
  "done": true,
  "clip_count": 5,
  "clips": [
    { "uuid": "22a9d58d...", "title": "The Secret to Going Viral",
      "score": 85, "duration": 32.4,
      "output": "/uploads/clips/.../22a9d58d....mp4",
      "thumbnail": "/uploads/clips/.../22a9d58d....jpg" }
  ]
}

3 · Executar uma ferramenta de utilidade (sincron)

As ferramentas ffmpeg devolvem um link de download diretamente. Passe a ferramenta slug (video-to-audio, compress-video, video-to-gif, trim-video, make-video-vertical, …).

curl -X POST https://clip.video/api/tool/ \
  -F "file=@clip.mp4" -F "slug=video-to-audio"
# -> { "error": false, "download": "/uploads/tools/out/....mp3", "name": "audio.mp3" }

4 · Exportação de uma transcrição

Para transcribe trabalho, exportar a transcrição como txt, srt, ou vtt.

curl https://clip.video/v/<job_id>/export/srt/ -o captions.srt

Preços

Ao contrário das APIs de crédito, o clip.video publica uma taxa de atacado por minuto no plano do Studio — factura os seus próprios usuários, como quiser. Preço ou Entre em contato conosco para as taxas de volume e o rótulo branco.