# Cut.Pro

> Documentação do cut.pro

## Docs

- [Autenticação](https://cut.pro/docs/api-reference/autenticacao.md): Como autenticar suas requisições e selecionar o workspace
- [Get balance](https://cut.pro/docs/api-reference/balance/get-balance.md): Returns your current credit balance. Credits are consumed each time you submit a video for clipping.
- [Get credit history](https://cut.pro/docs/api-reference/balance/get-credit-history.md): Returns the credit transaction ledger for this workspace, newest first. Each row shows the delta (`amount`, negative for debits), the resulting balance, and what caused it (`reference_type` + `reference_id`) so you can reconcile against submissions, renewals, refunds, and bonuses.
- [Apply template to clips](https://cut.pro/docs/api-reference/clips/apply-template-to-clips.md): Asynchronously applies one of your saved templates to all (or a subset of) the generated clips in a submission. The job runs in the background — returns immediately with the number of clips being processed.
- [Delete a clip](https://cut.pro/docs/api-reference/clips/delete-a-clip.md): Permanently deletes a single generated clip. This action cannot be undone.
- [List generated clips](https://cut.pro/docs/api-reference/clips/list-generated-clips.md): Returns the AI-generated highlight clips produced by a completed submission. Each clip includes its timestamp range within the source video, an AI relevance score, and signed URLs for streaming and downloading.
- [Get a connection](https://cut.pro/docs/api-reference/connections/get-a-connection.md): Returns a single connection by ID, with the latest captured audience metrics.
- [List connections](https://cut.pro/docs/api-reference/connections/list-connections.md): Returns the active social connections in this workspace — the IDs you pass as `connection_id` when creating a post. Each entry includes the platform, public profile info (username, avatar, bio) and the latest captured audience metrics (followers, posts, likes). Revoked or disconnected accounts are e…
- [Enviando um vídeo para clipagem](https://cut.pro/docs/api-reference/enviando-video.md): As duas formas de obter um video_id: por URL pública ou enviando seu próprio arquivo
- [Visão geral da API](https://cut.pro/docs/api-reference/introducao.md): Automatize a clipagem e renderização de vídeos com IA, de forma programática
- [Conectar via MCP](https://cut.pro/docs/api-reference/mcp.md): Use o CutPro dentro do Claude, ChatGPT e outras ferramentas de IA via Model Context Protocol
- [Publicando nas redes](https://cut.pro/docs/api-reference/postagem.md): Como publicar clipes renderizados no TikTok, Instagram, YouTube e mais
- [Create a post](https://cut.pro/docs/api-reference/posts/create-a-post.md): Creates a multi-platform post for one or more edited clips. Each entry under `videos` references an `edit_id` (the rendered or apply_template'd clip) plus a list of target connections with platform-specific metadata.
- [Delete a post](https://cut.pro/docs/api-reference/posts/delete-a-post.md): Permanently deletes a post and all its items. Already-published items remain live on the destination platforms — this only removes the CutPro record.
- [Delete a post item](https://cut.pro/docs/api-reference/posts/delete-a-post-item.md): Removes a single `pending` or `failed` item from a post. Published items cannot be removed (they live on the destination platform). If the deletion empties the parent post, the post is also removed and `post_deleted: true` is returned.
- [Get a post](https://cut.pro/docs/api-reference/posts/get-a-post.md): Returns full status of a post including every item. Poll this endpoint to track immediate posts through `pending → rendering → publishing → published`.
- [List posts](https://cut.pro/docs/api-reference/posts/list-posts.md): Returns a paginated list of posts in this workspace, newest first. Each post includes its items with current status and error codes.
- [Retry a failed item](https://cut.pro/docs/api-reference/posts/retry-a-failed-item.md): Re-queues a `failed` item for publishing. The item's `Error` and previous `render_id` are cleared. Only items currently in `failed` state can be retried.
- [Trigger publish](https://cut.pro/docs/api-reference/posts/trigger-publish.md): Forces the publishing pipeline to run for a post that is currently `pending`, `failed`, or stuck. Useful for scheduled posts you want to publish early, or to nudge a post whose worker missed its window.
- [Update a post](https://cut.pro/docs/api-reference/posts/update-a-post.md): Updates a post that is still pending. Two things can change:
- [Quickstart: seu primeiro clipe](https://cut.pro/docs/api-reference/quickstart.md): Do link do vídeo ao MP4 renderizado, com requisições reais
- [Limites de requisição](https://cut.pro/docs/api-reference/rate-limit.md): Como funciona o rate limit da API e como lidar com o status 429
- [Cancel or delete a render](https://cut.pro/docs/api-reference/renders/cancel-or-delete-a-render.md): Cancels a queued or active render, or permanently deletes a completed/failed/expired render record. Deleting a completed render also removes the rendered video file from storage.
- [Get bulk download status](https://cut.pro/docs/api-reference/renders/get-bulk-download-status.md): Returns the current state of a bulk download job. Poll every 5–10 seconds until `status` is `completed`. Once complete, `download_url` is a signed URL valid for one hour; the underlying file is purged once `expires_at` passes.
- [Get render download URL](https://cut.pro/docs/api-reference/renders/get-render-download-url.md): Returns a time-limited signed URL to download the completed rendered video as an MP4. The URL expires after **1 hour** — fetch it fresh each time rather than caching it.
- [Get render quota](https://cut.pro/docs/api-reference/renders/get-render-quota.md): Returns the workspace's current render usage and plan-level render limits. Use this before kicking off a render to avoid being throttled — if `usage.total_pending >= usage.max_concurrent`, a new render will be rejected with `429`.
- [Get render status](https://cut.pro/docs/api-reference/renders/get-render-status.md): Returns the current status of a render job. Poll this endpoint until `status` is `completed` or `failed`.
- [List renders](https://cut.pro/docs/api-reference/renders/list-renders.md): Returns a paginated list of all your render jobs, newest first. Filter by `status` to focus on processing, completed, or failed renders.
- [Render a clip](https://cut.pro/docs/api-reference/renders/render-a-clip.md): Queues a clip for video rendering. Returns a `render_id` you can use to poll status via `GET /renders/{renderId}`.
- [Start a bulk download](https://cut.pro/docs/api-reference/renders/start-a-bulk-download.md): Packages a set of completed renders into a single zip file. Returns a `job_id` immediately — poll `GET /renders/bulk-download/{job_id}` until `status` is `completed`, then download the zip from the returned URL.
- [Workspace e créditos](https://cut.pro/docs/api-reference/saldo.md): Como o workspace, o plano e o saldo de créditos funcionam na API
- [Analyze a video](https://cut.pro/docs/api-reference/submissions/analyze-a-video.md): Fetches metadata for a public video URL and calculates the exact credit cost before you commit to clipping. No credits are charged. Use this as a pre-flight check before calling `POST /clips`.
- [Delete submission](https://cut.pro/docs/api-reference/submissions/delete-submission.md): Permanently deletes a submission and all its generated clips. This action cannot be undone. Returns `409` if the submission is currently processing — wait for it to complete or fail first.
- [Get submission](https://cut.pro/docs/api-reference/submissions/get-submission.md): Returns the current status of a clipping submission. Poll this endpoint until `status` is `completed` or `failed`.
- [List submissions](https://cut.pro/docs/api-reference/submissions/list-submissions.md): Returns a paginated list of all clipping submissions for a video, newest first. Use this to audit past runs, find a specific submission ID, or check whether a job is still in progress.
- [Submit a video for clipping](https://cut.pro/docs/api-reference/submissions/submit-a-video-for-clipping.md): Queues a video for AI clipping. Credits are deducted immediately upon submission. Returns a `submission_id` to track progress.
- [List templates](https://cut.pro/docs/api-reference/templates/list-templates.md): Returns a paginated list of video editing templates. Use `filter=mine` (default) to list your own templates, or `filter=public` for CutPro's built-in public templates.
- [Complete an upload](https://cut.pro/docs/api-reference/videos/complete-an-upload.md): Registers a finished upload, captures its dimensions/duration, and returns the video metadata together with the exact credit cost — same payload shape as `POST /clips/info`. Pass the returned `video_id` to `POST /clips` to start a clipping submission.
- [Delete a video](https://cut.pro/docs/api-reference/videos/delete-a-video.md): Permanently deletes a video from your library along with all its submissions and generated clips. This action cannot be undone. Returns `409` if a submission is currently processing.
- [List videos](https://cut.pro/docs/api-reference/videos/list-videos.md): Returns a paginated list of all source videos in your library, ordered by most recent submission. Each item includes lifecycle counters (clips generated, edits, exports, posts) and the status of the latest submission.
- [Start an upload](https://cut.pro/docs/api-reference/videos/start-an-upload.md): Returns a presigned URL plus the generated `video_id` for uploading your own video file directly to storage. PUT the bytes to `upload_url` with the same `Content-Type` you declared here, then call `POST /videos/upload/complete` to register the upload and get the credit cost.
- [Get current workspace](https://cut.pro/docs/api-reference/workspace/get-current-workspace.md): Returns information about the workspace this API key represents — name, plan, credit balance, member count and the role of the user who created the key. Each API key is bound to a single workspace; to operate on a different workspace, create a separate key from inside that workspace.
- [Como Funcionam os Créditos](https://cut.pro/docs/billing/how-credits-work.md): Entenda o sistema de créditos do CutPro e como ele impacta sua produção de conteúdo
- [Pagamentos e Informações de Cobrança](https://cut.pro/docs/billing/payments-billing-info.md): Formas de pagamento, ciclo de cobrança, créditos e faturas do CutPro
- [Planos Disponíveis](https://cut.pro/docs/billing/plans.md): Compare os planos do CutPro e escolha o ideal para seu perfil de uso
- [Bem-vindo ao CutPro!](https://cut.pro/docs/getting-started/introduction.md): Transforme seus vídeos em clipes virais de forma simples e inteligente
- [Quantos Clipes Você Pode Gerar?](https://cut.pro/docs/making-first-clip/how-many-clips.md): Como a estratégia e o conteúdo determinam a quantidade de clipes gerados
- [Como criar seu primeiro clipe](https://cut.pro/docs/making-first-clip/passo-a-passo.md): O caminho completo, do link ao clipe pronto para postar — em poucos minutos
- [Tutoriais](https://cut.pro/docs/making-first-clip/tutoriais.md): Vídeos curtos mostrando o passo a passo dentro do CutPro
- [Limites de Duração](https://cut.pro/docs/making-first-clip/video-length.md): Entenda os limites de duração para vídeos de entrada e configurações no CutPro
- [De onde posso pegar vídeos?](https://cut.pro/docs/making-first-clip/video-sources.md): As plataformas e os tipos de vídeo que funcionam no CutPro
- [Guia para clipes que performam](https://cut.pro/docs/viral-guide/guia-viral.md): Boas práticas para transformar um vídeo longo em clipes que prendem atenção no TikTok, Reels e Shorts

## OpenAPI Specs

- [openapi](https://cut.pro/docs/openapi.json)