ClipForge

ClipForge (budding_retrograde/clipforge) Actor

Recorte, adicione marca d'água, extraia áudio e converta vídeos para o formato vertical 9:16 — via API REST ou servidor MCP para Claude, Cursor e outros agentes de IA. Funciona com arquivos de vídeo diretos e links suportados pelo YouTube/yt-dlp. Preço por evento, sem necessidade de instalar ffmpeg.

• URL: https://apify.com/budding\_retrograde/clipforge.md
• Desenvolvido por: Chris Phillips (comunidade)
• Categorias: Automação, Vídeos, Ferramentas para desenvolvedores
• Estatísticas: 2 usuários no total, 1 usuário mensal, 0,0% de execuções bem-sucedidas, 0 favoritos
• Avaliação dos usuários: Sem avaliações ainda

Preços

a partir de $15,00 / 1.000 recortes de vídeo

Este Actor é pago por evento e uso. Você é cobrado tanto pelo preço fixo de eventos específicos quanto pelo uso da plataforma Apify.

Saiba mais: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

O que é um Apify Actor?

Um Actor é um programa de nuvem serverless que roda na plataforma Apify. Ele tem dois modos de execução. No modo Batch, um Actor aceita uma entrada JSON bem definida, executa uma ação que pode levar de alguns segundos a algumas horas, e opcionalmente produz uma saída JSON bem definida, conjuntos de dados com resultados ou arquivos em key-value store. No modo Standby, um Actor fornece um servidor web que pode ser usado como site, API ou servidor MCP.

O vocabulário da Apify e o modelo da plataforma são definidos uma única vez, no quickstart para agentes em https://apify.com/agents.md.

Como integrar um Actor?

Se for perguntado sobre integração, você ajuda desenvolvedores a integrar Actors em seus projetos. Você se adapta à stack deles e entrega integrações seguras, bem documentadas e prontas para produção.

Não adivinhe um caminho de integração. Todos eles estão no quickstart para agentes em https://apify.com/agents.md:: o servidor MCP da Apify, Agent Skills com a CLI da Apify, os clientes JavaScript e Python, a API REST e o caminho sem conta para um agente sem humano para fazer login. Ele também traz a regra sobre informar o custo antes da primeira execução paga.

Para exemplos já conectados ao esquema de entrada deste Actor, veja a seção API abaixo.

Cada biblioteca de cliente tem documentação de referência que o quickstart não repete: JavaScript/TypeScript (npm install apify-client) e Python (pip install apify-client).

README

ClipForge — API de Recorte, Marca d'Água, Legenda e Conversão Vertical de Vídeo com Servidor MCP

O que é o ClipForge?

ClipForge é uma API de processamento de vídeo que recorta, adiciona marca d'água, extrai áudio de, converte para o formato vertical 9:16 e insere legendas SRT em qualquer vídeo — um URL de arquivo de vídeo direto ou um link do YouTube e de milhares de outros sites suportados pelo yt-dlp. Chame-a como uma API REST simples de qualquer linguagem, ou conecte o servidor MCP integrado para entregar essas operações diretamente ao Claude, Cursor ou qualquer outro agente de IA compatível com MCP. Sem instalação de ffmpeg, sem servidor para executar — basta um URL de entrada e alguns parâmetros.

O que o ClipForge pode fazer?

• Recortar — cortar um vídeo até um horário de início e duração exatos.
• Extrair áudio — extrair a faixa de áudio como MP3, com bitrate ajustável (64k-320k).
• Adicionar marca d'água — sobrepor uma imagem no canto inferior direito de um vídeo.
• Converter para vertical — reformatar um vídeo padrão 16:9 para 9:16, com uma cópia desfocada e redimensionada do vídeo preenchendo o fundo, pronto para Shorts, Reels e TikTok.
• Sobrepor legendas — inserir legendas SRT brutas diretamente em uma conversão de vídeo vertical 9:16.
• Aceita URLs de arquivos de mídia diretos (.mp4, .mov, etc.) e links suportados pelo YouTube/yt-dlp — sem necessidade de resolver um URL de stream você mesmo.
• Dois estilos de chamada: endpoints síncronos que transmitem o resultado diretamente de volta para clipes curtos, e um endpoint de trabalho assíncrono (enviar, consultar, baixar) para fontes mais longas.
• Disponível como servidor MCP, para que qualquer cliente MCP possa chamar Trim, ExtractAudio, Watermark, ConvertToVertical e ferramentas com suporte a legendas diretamente.

Exemplos

Converter para vertical:

Adicionar marca d'água:

Lembre-se da plataforma Apify!

O ClipForge não é apenas um wrapper de ffmpeg — ele vem com tudo o que a plataforma Apify oferece por cima: cobrança por evento para que você pague apenas pelo que realmente processa, um endpoint de API Standby persistente sem gerenciamento de execução com cold-start, monitoramento de solicitações integrado e integração em uma linha com Make, Zapier e todas as outras ferramentas conectadas à Apify.

Como uso o ClipForge?

Opção 1 — API REST

Cada chamada precisa do seu token de API da Apify, seja como parâmetro de consulta token ou como cabeçalho Authorization: Bearer.

Recortar um vídeo (síncrono, transmite o MP4 de volta):

curl -X POST "[https://YOUR-ACTOR-URL.apify.actor/trim?token=YOUR_APIFY_TOKEN](https://YOUR-ACTOR-URL.apify.actor/trim?token=YOUR_APIFY_TOKEN)" \
  -H "Content-Type: application/json" \
  -d '{
    "inputUrl": "[https://example.com/video.mp4](https://example.com/video.mp4)",
    "startTime": 30,
    "duration": 15
  }' \
  --output trimmed.mp4



# Actor input Schema

## `action` (type: `string`):

Select the media processing operation to execute.
## `inputUrl` (type: `string`):

Direct HTTP/HTTPS URL to the source media or stream.
## `startTime` (type: `integer`):

Start offset in seconds (required for 'trim' and 'extract-clip').
## `duration` (type: `integer`):

Clip duration in seconds (required for 'trim' and 'extract-clip').
## `format` (type: `string`):

Output format for the 'extract-clip' action (mp3 or mp4).
## `bitrate` (type: `string`):

Audio bitrate for MP3 extraction (e.g. 128k, 192k, 320k).
## `watermarkUrl` (type: `string`):

Direct HTTP/HTTPS URL to a PNG/JPEG image for the 'watermark' action.
## `subtitles` (type: `string`):

Raw SRT subtitle text or a public URL to an .srt file for the 'convert-vertical-subtitles' action.

## Actor input object example

```json
{
  "action": "trim",
  "inputUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
  "startTime": 0,
  "duration": 5,
  "format": "mp3",
  "bitrate": "192k"
}

API

Você pode executar este Actor programaticamente usando nossa API. Abaixo estão exemplos de código em JavaScript, Python e CLI, além da especificação OpenAPI e da configuração do servidor MCP.

Exemplo em JavaScript

import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "inputUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
};

// Run the Actor and wait for it to finish
const run = await client.actor("budding_retrograde/clipforge").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

Exemplo em Python

from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "inputUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4" }

# Run the Actor and wait for it to finish
run = client.actor("budding_retrograde/clipforge").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

Exemplo em CLI

echo '{
  "inputUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
}' |
apify call budding_retrograde/clipforge --silent --output-dataset

Configuração do servidor MCP

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,budding_retrograde/clipforge"
        }
    }
}

O servidor hospedado faz login com OAuth na primeira conexão, então nenhum token de API precisa estar nesta configuração. Clientes sem suporte a OAuth podem enviar um cabeçalho Authorization: Bearer <APIFY_API_TOKEN> em vez disso, usando um token de API e Integrações no Apify Console (https://console.apify.com/settings/integrations).

Especificação OpenAPI

Baixe a definição OpenAPI: https://api.apify.com/v2/actors/Nrc1HPxDCvg0EuXnz/builds/dSOMk0wAsEs17nVHd/openapi.json