Nada além do valor do seu plano, a partir de $7/mo com cobrança anual. Cada execução usa um dos vídeos mensais de AI Clips do seu plano: 10 no Starter, 50 no Pro e 100 no Business. Não há cobrança por minuto ou por requisição. O plano Free não inclui a API.

Para cada corte: ID, título, descrição, pontuação de potencial viral de 0 a 100, início e fim no vídeo original, duração, link de prévia e link para editar no StoryCut. A exportação gera um MP4 em 9:16 de até 1080p, sem marca-d’água.

Recurso

API de cortes de vídeo: transforme vídeos longos em Shorts com seu código

Q: O StoryCut tem uma API?

Sim. A API REST do StoryCut inicia processos de AI Clips a partir de um link do YouTube, lista os cortes com suas pontuações de potencial viral e exporta os vídeos em MP4, com webhooks assinados quando cada etapa é concluída. Está incluída nos planos Starter, Pro e Business.

Q: Quais vídeos posso enviar?

Links públicos do YouTube com duração de 2 a 150 minutos. Não é possível acessar vídeos privados, exclusivos para membros ou com restrição de idade. Para criar cortes de um arquivo no seu computador, faça o upload pelo site.

Q: Quanto tempo leva uma tarefa?

Cerca de 10 a 15 minutos para um vídeo longo. Adicione um webhook para receber uma notificação quando run.completed for concluído ou consulte GET /v1/runs/{id}, que também mostra o progresso em %.

Q: Como verifico se um webhook veio do StoryCut?

Cada webhook inclui o cabeçalho X-StoryCut-Signature: sha256= seguido do HMAC-SHA256 do corpo original da requisição, gerado com o segredo do seu webhook. Calcule o mesmo valor no seu servidor e compare. Responda com um status 2xx em até 10 segundos; caso contrário, o StoryCut tentará novamente após 10 segundos e depois de 1 minuto.

Q: Posso editar um corte antes de exportar?

Sim. Abra o link de edição do corte no editor do StoryCut, altere as legendas ou adicione zoom, música ou efeitos sonoros. A próxima exportação pela API incluirá essas alterações.

Q: Há limites de requisições?

120 requisições por minuto para cada chave de API. O número de execuções é limitado pelos vídeos mensais de AI Clips do seu plano; GET /v1/usage mostra quantos ainda restam.

Q: Como a API se compara às APIs do OpusClip, Submagic e Vizard?

Todos eles começam a criar cortes a partir de um link do YouTube. A API do StoryCut custa a partir de $9/mo ($7/mo com cobrança anual) e contabiliza execuções, não minutos: um podcast de 90 minutos conta como um dos vídeos mensais do seu plano. Em 21 de outubro de 2026, a API do OpusClip está disponível no plano Pro ($29 por mês, ou $14.50 com cobrança anual), com até 15 horas de cortes por API por mês. O Submagic inclui de 10 a 100 minutos de API por mês, com pacotes a partir de $57, e o Vizard usa os minutos de upload do seu plano. A tabela acima tem o link de cada fonte.

Q: O OpusClip tem uma API?

Sim. A documentação do OpusClip (consultada em 21 de outubro de 2026) informa que o acesso à API está disponível nos planos Pro (beta), Max e Business, e é cobrado em créditos de um minuto cada, com mínimo de 10 créditos por projeto. A API do StoryCut está incluída a partir do plano Starter, por $7/mo com cobrança anual.

Envie um link do YouTube. O StoryCut encontra os melhores momentos, ajusta o enquadramento para 9:16 com foco em quem está falando, adiciona legendas animadas e dá uma nota para cada corte. Consulte os cortes, exporte em MP4 e receba um webhook quando cada etapa for concluída.

Obtenha sua chave de API

Incluída nos planos Starter, Pro e Business
Sem cobrança por minuto de API
Webhooks assinados

Atualizado em 21 de outubro de 2026

API do StoryCut: principais informações

O que ele faz: Transforma um vídeo do YouTube em até 12 cortes verticais, cada um com legendas animadas, título e nota de viralidade de 0 a 100. Depois, exporta qualquer corte em MP4.
Entrada: Um link público do YouTube, com duração de 2 a 150 minutos (se o vídeo for mais longo, são usados os primeiros 150 minutos). Duração dos cortes: curto (15–30 s), médio (30–59 s) ou longo (60–89 s).
Arquivos gerados: JSON com o título, a nota, o início e o fim de cada corte, além de um link de prévia e um link para edição. Os arquivos são MP4s em 9:16 de até 1080p, sem marca d’água, com um link de download válido por 24 horas.
Webhooks: run.completed, run.failed, export.completed e export.failed, cada um assinado com HMAC-SHA256. Até 5 endpoints por conta.
Preço: Incluída nos planos Starter ($7/mo com cobrança anual), Pro e Business. Cada execução usa um dos vídeos de AI Clips mensais do plano: 10, 50 ou 100. Sem cobrança por minuto.
Limites: 120 solicitações por minuto por chave de API. Uma execução leva cerca de 10 a 15 minutos.

O que a API do StoryCut faz

A API usa o mesmo mecanismo de AI Clips do site do StoryCut. Você envia um link do YouTube; a IA analisa a transcrição, escolhe os momentos com uma abertura forte e uma ideia completa, ajusta cada corte para o formato vertical com foco nos rostos e em quem está falando, adiciona legendas animadas e dá uma nota de viralidade. Seu código consulta os cortes, começando pelos melhores, e exporta os que quiser.

Tudo fica na sua conta do StoryCut. Cada corte também tem um link de edição: abra-o no editor do StoryCut para mudar o estilo das legendas ou adicionar zooms, música ou efeitos sonoros. A próxima exportação pela API inclui essas edições.

Para desenvolvedores

De um link do YouTube a um MP4 em três chamadas

Envie sua chave de API como um token Bearer. Todas as respostas são JSON; os erros retornam como { "error": { "code", "message" } } junto com o status HTTP.

# 1. Start a run
curl https://app.storycut.com/v1/runs \
  -H "Authorization: Bearer $STORYCUT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"youtube_url": "https://www.youtube.com/watch?v=VIDEO_ID", "clip_length": "short"}'

# 2. About 10-15 minutes later (or on the run.completed webhook): the clips, best first
curl https://app.storycut.com/v1/runs/RUN_ID/clips -H "Authorization: Bearer $STORYCUT_KEY"

# 3. Export a clip, then get its download link
curl -X POST https://app.storycut.com/v1/clips/CLIP_ID/export -H "Authorization: Bearer $STORYCUT_KEY"
curl https://app.storycut.com/v1/exports/EXPORT_ID -H "Authorization: Bearer $STORYCUT_KEY"

URL base: https://app.storycut.com/v1. A documentação completa, suas chaves e seus webhooks estão no StoryCut, em API & Integrations.

Endpoints

POST /v1/runs

Inicia uma execução a partir de um link do YouTube, com a duração de corte desejada. Retorna o ID da execução imediatamente.

GET /v1/runs/{id}

Status da execução (processing, completed ou failed), progresso em % e número de cortes.

GET /v1/runs/{id}/clips

Os cortes, começando pelos melhores: título, nota, início e fim, link de prévia e link de edição.

POST /v1/clips/{id}/export

Exporta um corte com as legendas e as edições salvas nele. GET /v1/exports/{id} retorna o link para download.

Webhooks

O StoryCut envia uma solicitação POST assinada ao seu servidor quando uma execução ou exportação é concluída ou falha. Assim, você não precisa ficar consultando o status.

GET /v1/usage

Seu plano e o que ainda resta neste mês, para que um script possa parar antes de atingir o limite.

Seu código

Seu código inicia a execução. Um webhook avisa quando ela termina.

Uma execução leva cerca de 10 a 15 minutos, então você não precisa esperar. Configure um webhook e o StoryCut chama seu servidor com run.completed quando os cortes estiverem prontos e, depois, com export.completed e o link para download quando um corte for renderizado. Cada solicitação é assinada com o segredo do seu webhook, para que seu servidor possa confirmar que ela veio do StoryCut.

Código que inicia uma execução do StoryCut e processa seus webhooks, ao lado dos cortes finalizados com notas de viralidade e de um evento export.completed com link para download

Como funciona

Como começar a usar a API

01
Crie uma chave
Em um plano Starter, Pro ou Business, abra API & Integrations no StoryCut e clique em Create key. A chave é exibida uma única vez: guarde-a nas variáveis de ambiente do seu servidor.
02
Inicie uma execução
Envie POST /v1/runs com um link do YouTube. A resposta com o ID da execução chega imediatamente.
03
Obtenha os cortes
Aguarde o webhook run.completed ou consulte GET /v1/runs/{id}. Depois, consulte os cortes, começando pelos melhores.
04
Exporte
Envie POST /v1/clips/{id}/export. O link para download chega com export.completed ou pode ser consultado em GET /v1/exports/{id}.

O que as pessoas automatizam com ela

Fluxos para podcasts e webinars

Um novo episódio vai ao ar, seu script envia o link e, cerca de 15 minutos depois, os melhores cortes estão prontos.

Fluxos de trabalho com n8n e Make

Chame a API em uma etapa de solicitação HTTP e inicie a próxima etapa com o webhook: sem precisar hospedar código.

Agências

Processe todos os vídeos dos clientes pelas mesmas etapas e abra um corte no editor do StoryCut quando ele precisar de um toque humano.

Assistentes de IA

Prefere pedir por chat? As mesmas execuções podem ser iniciadas pelo Claude ou pelo ChatGPT com o conector MCP do StoryCut, em qualquer plano.

Comparação entre APIs de cortes de vídeo

Comparativo de APIs de cortes por preço, uso, webhooks e limites, com base na página de preços e na documentação de cada ferramenta, consultadas em 2026-10-21
Recurso	StoryCut	OpusClip	Submagic	Vizard	Klap
API incluída a partir do plano	Starter: $9/mo ($7/mo com cobrança anual)	Pro: $29/mo ($14.50/mo com cobrança anual)	Starter: $19/mo ($12/mo com cobrança anual)	Creator: $29/mo ($14.50/mo com cobrança anual)	Pague por uso: $0.32 por corte, $0.44 por vídeo, $0.48 por exportação
Como o uso da API é contabilizado	Execuções: 10, 50 ou 100 vídeos longos por mês do plano, com duração de até 150 min	Créditos, 1 por minuto, mínimo de 10 por projeto; até 15 horas por mês no Pro	De 10 a 100 minutos de API por mês, depois pacotes a partir de $57 por 250 minutos	Minutos de upload do plano, 1 crédito por minuto (600 por mês no Creator)	Por operação
Cortes a partir de um link do YouTube	Sim	Sim	Sim	Sim	Sim
Webhooks	Simassinados com HMAC-SHA256	Simassinados	Sim	Simdefinidos no espaço de trabalho	Nãoa documentação mostra consultas periódicas
Limite de requisições	120 requisições por minuto	30 requisições por minuto	Não informado	3 por minuto no Creator	Não informado
Conector para Claude e ChatGPT (MCP)	Simtodos os planos	Sim	Sim	Não verificado	Não verificado