Quickstart
Faça sua primeira requisição e saia com um clipe vertical em MP4.
Neste guia você confere a chave com uma chamada que não cobra nada, analisa um vídeo, gera os clipes e baixa o melhor deles renderizado.
Você vai precisar de: uma conta na Cut.Pro, uma chave de API e curl. Os exemplos completos no fim usam Node.js 18+ ou Python 3.9+.
1. Crie a chave
Abra Chaves de API, clique em Nova chave e copie o valor. Ele aparece uma vez só.
export CUTPRO_API_KEY="cole_sua_chave_aqui"2. Confira a chave
GET /workspace não cobra créditos e mostra em qual workspace a chave opera.
curl https://api.cut.pro/api/v1/workspace \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"id": "7401220118845503",
"name": "Estúdio Ana",
"is_personal": true,
"status": "active",
"role": "admin",
"plan_name": "Pro",
"plan_is_free": false,
"credits": 120,
"credits_unlimited": false,
"created_at": "2026-03-02T14:11:09.000Z"
}Recebeu 401 UNAUTHORIZED? A chave está errada ou foi revogada. Recebeu 400 MISSING_WORKSPACE_ID? A chave alcança mais de um workspace: veja Autenticação.
3. Analise o vídeo
Analisar é de graça. A resposta traz o custo da clipagem e o seu saldo.
curl -X POST https://api.cut.pro/api/v1/clips/info \
-H "X-Api-Key: $CUTPRO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }'{
"id": "7412908365112823",
"title": "Rick Astley - Never Gonna Give You Up",
"platform": "youtube",
"duration": 213,
"credits_cost": 4,
"current_balance": 120
}Guarde o id: ele é o video_id dos próximos passos.
4. Gere os clipes
Este é o passo que cobra. O valor de credits_cost sai do saldo na hora, e volta se você cancelar antes de terminar.
curl -X POST https://api.cut.pro/api/v1/clips \
-H "X-Api-Key: $CUTPRO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "video_id": "7412908365112823" }'{
"id": "7412908371004912",
"video_id": "7412908365112823",
"status": "queued",
"credits_charged": 4
}5. Espere terminar
Consulte a submissão a cada 5 a 10 segundos até status virar completed ou failed.
curl https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912 \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"id": "7412908371004912",
"video_id": "7412908365112823",
"status": "completed",
"error_code": null,
"clips_count": 9,
"completed_at": "2026-10-29T18:04:51.000Z"
}6. Pegue o melhor clipe
Cada clipe tem uma nota de 0 a 10. Ordene por ela e peça um só.
curl "https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/clips?sort=rating&order=desc&limit=1" \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"clips": [
{
"id": "7412908412887301",
"title": "O refrão que todo mundo sabe",
"rating": 9.2,
"start_time": 42.5,
"end_time": 71.0,
"language": "en",
"has_template_applied": false,
"edit_id": null
}
],
"pagination": { "current_page": 1, "total_pages": 9, "total_count": 9, "has_next_page": true, "has_previous_page": false, "limit": 1 }
}7. Renderize e baixe
Peça o render do clipe. Sem template, ele sai com as configurações padrão.
curl -X POST https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/clips/7412908412887301/render \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"id": "7412908490112774",
"edit_id": "7412908488820131",
"status": "queued",
"output_resolution": "1080p",
"from_cache": false,
"download_url": null
}Consulte GET /renders/7412908490112774 até status virar completed e peça o link:
curl https://api.cut.pro/api/v1/renders/7412908490112774/download \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"url": "https://...",
"filename": "o-refrao-que-todo-mundo-sabe.mp4"
}O link vale 1 hora. Pronto: esse é o seu clipe.
O fluxo inteiro em um arquivo
Os passos 3 a 7 encadeados, com a espera resolvida. Troque a URL e rode.
const API = "https://api.cut.pro/api/v1";
const headers = { "X-Api-Key": process.env.CUTPRO_API_KEY, "Content-Type": "application/json" };
const PENDING = ["queued", "active", "waiting_quality"];
async function call(path, init) {
const response = await fetch(`${API}${path}`, { ...init, headers });
const body = await response.json();
if (!response.ok) throw new Error(`${response.status} ${body.code}`);
return body;
}
const wait = (seconds) => new Promise((resolve) => setTimeout(resolve, seconds * 1000));
const video = await call("/clips/info", {
method: "POST",
body: JSON.stringify({ url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }),
});
console.log(`${video.title}: ${video.credits_cost} créditos`);
const submission = await call("/clips", { method: "POST", body: JSON.stringify({ video_id: video.id }) });
const base = `/clips/${video.id}/submissions/${submission.id}`;
let state = submission;
while (state.status !== "completed") {
if (state.status === "failed") throw new Error(state.error_code);
await wait(10);
state = await call(base);
}
const { clips: [best] } = await call(`${base}/clips?sort=rating&order=desc&limit=1`);
const render = await call(`${base}/clips/${best.id}/render`, { method: "POST" });
let url = render.download_url;
while (!url) {
await wait(10);
const job = await call(`/renders/${render.id}`);
if (job.status === "completed") url = (await call(`/renders/${render.id}/download`)).url;
else if (!PENDING.includes(job.status)) throw new Error(job.status);
}
console.log(best.title, url);Ajuste o código
- Corte só um trecho: mande
timeframe: { "start": 600, "end": 1800 }emPOST /clipspara clipar do minuto 10 ao 30. - Aplique seu estilo: passe um
template_iddeGET /templatesemPOST /clipse todo clipe sai com a sua legenda e o seu enquadramento. - Traduza a legenda:
translate_to: "es"emPOST /clipsgera as legendas em espanhol. Custa mais que a clipagem simples, ecredits_chargedmostra quanto saiu. - Use um arquivo seu: troque o passo 3 pelo upload, que devolve o mesmo
video_id.