API.

Autenticação

Authorization: Bearer fv_live_xxxxxxxx_...

Cortar um vídeo

curl -X POST https://cortesfervo.com.br/api/v1/clips \
  -H "Authorization: Bearer $FERVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://youtube.com/watch?v=...",
    "title": "Episódio 148",
    "settings": { "max_clips": 15, "reframe": "dividida", "caption_preset": "Varal" },
    "rights_confirmed": true
  }'

→ 201 { "id": "8a1c…", "status": "na_fila" }

Consultar o projeto

curl https://cortesfervo.com.br/api/v1/clips/8a1c… -H "Authorization: Bearer $FERVO_KEY"

→ { "status": "pronto", "clips": [ { "title": "...", "viral_score": 94,
     "score_breakdown": [...], "download_url": "https://…" } ] }

Gerar vídeo ou imagem

curl -X POST https://cortesfervo.com.br/api/v1/generations \
  -H "Authorization: Bearer $FERVO_KEY" -H "Content-Type: application/json" \
  -d '{ "model": "kling-3-0", "prompt": "drone sobre Olinda no carnaval", "params": { "duration": 5, "aspect": "9:16" } }'

Cardápio e cotação

GET https://cortesfervo.com.br/api/v1/models
GET https://cortesfervo.com.br/api/quote?model=veo-3-1-fast&qty=8

Webhooks

Cadastre uma URL HTTPS em Ajustes. Enviamos project.ready, generation.ready e post.published com o header X-Fervo-Signature (HMAC-SHA256 do corpo com o segredo do endpoint).

Erros

401 chave inválida · 402 saldo insuficiente · 403 escopo · 422 corpo inválido · 429 limite de 60 req/min.