Renderize e baixe o vídeo

O clipe que a IA corta é cru. O render transforma o clipe num MP4 vertical com template, legendas e efeitos, pronto para postar.

apply_template (opcional)  →  POST .../render  →  GET /renders/{id}  →  GET /renders/{id}/download
      edição                   202 queued          até completed           URL de 1 hora

Aplique um templateCopy Anchor Link

Templates são edições salvas na Cut.Pro: enquadramento, estilo de legenda, efeitos. Liste os seus:

curl "https://api.cut.pro/api/v1/templates?filter=mine" \
  -H "X-Api-Key: $CUTPRO_API_KEY"

Cada item traz id, name, aspect_ratio e auto_add_captions. filter=public lista os da Cut.Pro.

Para editar os clipes de uma submissão de uma vez:

curl -X POST https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/apply_template \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "template_id": "7398110254410021", "clip_ids": ["7412908412887301"] }'

{ "clips_count": 1 }

Sem clip_ids, vale para todos os clipes. Roda em segundo plano: cada clipe ganha edit_id em GET .../clips quando termina. Um lote por conta de cada vez; outro responde 429 BATCH_ALREADY_RUNNING.

Mais simples: mande template_id já em POST /clips e todo clipe sai editado.

Renderize um clipeCopy Anchor Link

curl -X POST https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/clips/7412908412887301/render \
  -H "X-Api-Key: $CUTPRO_API_KEY"

{
  "id": "7412910087712256",
  "edit_id": "7412910087700001",
  "status": "queued",
  "has_watermark": false,
  "output_resolution": "1080p",
  "from_cache": false,
  "download_url": null
}

Com template aplicado, o render usa a edição. Sem template, usa o layout padrão. Guarde o edit_id: é ele que publica o vídeo e que gera um arquivo novo depois.

Se um render idêntico já está pronto, a resposta é 200 com from_cache: true e download_url preenchido. Não há fila nem custo de espera. Pedir o mesmo clipe enquanto ele renderiza responde 409 RENDER_ALREADY_IN_PROGRESS.

Clipe de live tem rota própria: POST /monitors/{id}/broadcasts/{broadcastId}/clips/{clipId}/render.

Acompanhe o renderCopy Anchor Link

curl https://api.cut.pro/api/v1/renders/7412910087712256 \
  -H "X-Api-Key: $CUTPRO_API_KEY"

Consulte a cada 5 a 10 segundos. progress vai de 0 a 100, bom para barra de progresso.

Baixe o MP4Copy Anchor Link

curl https://api.cut.pro/api/v1/renders/7412910087712256/download \
  -H "X-Api-Key: $CUTPRO_API_KEY"

{ "url": "https://...", "filename": "O refrão que todo mundo sabe.mp4" }

Renderize de novoCopy Anchor Link

A edição nunca expira. Para ter o MP4 de um clipe de meses atrás, renderize o edit_id:

curl -X POST https://api.cut.pro/api/v1/renders \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "edit_id": "7412910087700001" }'

Vale o edit_id de um render, de um clipe ou de um item de post. A resposta tem o mesmo formato de renderizar um clipe.

Baixe vários num zipCopy Anchor Link

curl -X POST https://api.cut.pro/api/v1/renders/bulk-download \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "render_ids": ["7412910087712256", "7412910087712257"] }'

curl https://api.cut.pro/api/v1/renders/bulk-download/$JOB_ID \
  -H "X-Api-Key: $CUTPRO_API_KEY"

• Até 500 renders por zip. Mais que isso responde 400 TOO_MANY_RENDERS.
• Ids de outro workspace são ignorados. Se nenhum sobra, 404 NO_VALID_RENDERS.
• download_url aparece em completed e vale 1 hora. O zip some em expires_at; depois disso, 410 JOB_EXPIRED.

Liste e apagueCopy Anchor Link

ErrosCopy Anchor Link