> ## Documentation Index
> Fetch the complete documentation index at: https://cut.pro/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral da API

> Automatize a clipagem e renderização de vídeos com IA, de forma programática

A **API da CutPro** permite automatizar todo o fluxo de clipagem com IA: você envia o link de um vídeo, a IA encontra os melhores momentos, e você recebe os clipes prontos para renderizar e publicar — tudo via requisições HTTP.

<Card icon="rocket" href="/api-reference/quickstart" horizontal>
  **Com pressa?** Vá direto para o **Quickstart** e gere seu primeiro clipe via API em poucos minutos.
</Card>

## URL base

Todas as rotas usam o prefixo:

```
https://api.cut.pro/api/v1
```

## O fluxo típico

A API segue o mesmo caminho do estúdio, em etapas que você controla por requisição:

<Steps>
  <Step title="Analisar (sem custo)">
    Pré-visualize metadados e o custo em créditos de um link público, sem ser cobrado.

    `POST /clips/info`
  </Step>

  <Step title="Enviar para clipagem">
    Submeta o vídeo. **Os créditos são debitados na hora.**

    `POST /clips`
  </Step>

  <Step title="Acompanhar a submissão">
    Faça polling até o `status` virar `completed` ou `failed`.

    `GET /clips/{videoId}/submissions/{submissionId}`
  </Step>

  <Step title="Buscar os clipes gerados">
    Pegue os clipes que a IA produziu, com timestamps, nota e URLs.

    `GET /clips/{videoId}/submissions/{submissionId}/clips`
  </Step>

  <Step title="Aplicar um template (opcional)">
    Aplique um dos seus templates em lote aos clipes.

    `POST /clips/{videoId}/submissions/{submissionId}/apply_template`
  </Step>

  <Step title="Renderizar cada clipe">
    Gere o MP4 final de cada clipe e faça polling até concluir.

    `POST /clips/{videoId}/submissions/{submissionId}/clips/{clipId}/render` → `GET /renders/{renderId}`
  </Step>

  <Step title="Baixar e publicar">
    Baixe o vídeo renderizado e, se quiser, publique nas redes.

    `GET /renders/{renderId}/download` · `POST /posts`
  </Step>
</Steps>

## Próximos passos

<CardGroup cols={2}>
  <Card icon="key" title="Autenticação" href="/api-reference/autenticacao">
    Como gerar sua chave e enviar nas requisições, incluindo workspaces.
  </Card>

  <Card icon="terminal" title="Quickstart" href="/api-reference/quickstart">
    Um exemplo completo, do link ao MP4 renderizado.
  </Card>

  <Card icon="coins" title="Workspace e créditos" href="/api-reference/saldo">
    Como o consumo de créditos funciona em cada submissão.
  </Card>

  <Card icon="send" title="Publicação" href="/api-reference/postagem">
    Como publicar os clipes renderizados nas redes sociais.
  </Card>
</CardGroup>