> ## 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.

# API overview

> Automate AI-powered video clipping and rendering programmatically

The **CutPro API** lets you automate the entire AI clipping flow: you send a video link, the AI finds the best moments, and you receive clips ready to render and publish, all over HTTP requests.

<Card icon="rocket" href="/docs/en/api-reference/quickstart" horizontal>
  **In a hurry?** Go straight to the **Quickstart** and generate your first clip via the API in just a few minutes.
</Card>

## Base URL

Every route uses the prefix:

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

## The typical flow

The API follows the same path as the studio, in steps you control per request:

<Steps>
  <Step title="Analyze (no cost)">
    Preview the metadata and credit cost of a public link, without being charged.

    `POST /clips/info`
  </Step>

  <Step title="Send for clipping">
    Submit the video. **Credits are debited immediately.**

    `POST /clips`
  </Step>

  <Step title="Track the submission">
    Poll until `status` becomes `completed` or `failed`.

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

  <Step title="Fetch the generated clips">
    Get the clips the AI produced, with timestamps, rating, and URLs.

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

  <Step title="Apply a template (optional)">
    Apply one of your templates in bulk to the clips.

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

  <Step title="Render each clip">
    Generate the final MP4 of each clip and poll until done.

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

  <Step title="Download and publish">
    Download the rendered video and, if you want, publish it to your social accounts.

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

## Next steps

<CardGroup cols={2}>
  <Card icon="key" title="Authentication" href="/docs/en/api-reference/autenticacao">
    How to generate your key and send it in requests, including workspaces.
  </Card>

  <Card icon="terminal" title="Quickstart" href="/docs/en/api-reference/quickstart">
    A complete example, from link to rendered MP4.
  </Card>

  <Card icon="coins" title="Workspace and credits" href="/docs/en/api-reference/saldo">
    How credit consumption works on each submission.
  </Card>

  <Card icon="send" title="Publishing" href="/docs/en/api-reference/postagem">
    How to publish rendered clips to social networks.
  </Card>
</CardGroup>