ClipForge

Recorta, añade marcas de agua, extrae audio y convierte cualquier video a formato vertical 9:16 — mediante API REST o herramientas MCP para Claude, Cursor y otros agentes de IA.

Documentación

ClipForge (budding_retrograde/clipforge) Actor

Recorta, añade marcas de agua, extrae audio y convierte videos a formato vertical 9:16 — mediante API REST o servidor MCP para Claude, Cursor y otros agentes de IA. Funciona con archivos de video directos y enlaces compatibles con YouTube/yt-dlp. Precio por evento, sin necesidad de instalar ffmpeg.

Precios

desde $15.00 / 1,000 recortes de video

Este Actor se paga por evento y uso. Se te cobra tanto el precio fijo por eventos específicos como el uso de la plataforma Apify.

Más información: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

¿Qué es un Apify Actor?

Un Actor es un programa en la nube sin servidor que se ejecuta en la plataforma Apify. Tiene dos modos de ejecución. En modo Batch, un Actor acepta una entrada JSON bien definida, realiza una acción que puede tomar desde unos segundos hasta unas horas, y opcionalmente produce una salida JSON bien definida, conjuntos de datos con resultados, o archivos en el almacén de clave-valor. En modo Standby, un Actor proporciona un servidor web que puede usarse como sitio web, API o servidor MCP.

El vocabulario de Apify y el modelo de la plataforma se definen una sola vez, en la guía de inicio rápido para agentes en https://apify.com/agents.md.

¿Cómo integrar un Actor?

Si te preguntan sobre integración, ayudas a los desarrolladores a integrar Actores en sus proyectos. Te adaptas a su stack y entregas integraciones seguras, bien documentadas y listas para producción.

No adivines una ruta de integración. Cada una de ellas está en la guía de inicio rápido para agentes en https://apify.com/agents.md: el servidor MCP de Apify, Agent Skills con la CLI de Apify, los clientes de JavaScript y Python, la API REST, y la ruta sin cuenta para un agente sin humano que inicie sesión. También incluye la regla sobre indicar el costo antes de la primera ejecución de pago.

Para ejemplos ya conectados al esquema de entrada de este Actor, consulta la sección API a continuación.

Cada biblioteca de cliente tiene documentación de referencia que la guía de inicio rápido no repite: JavaScript/TypeScript (npm install apify-client) y Python (pip install apify-client).

README

ClipForge — API de Recorte, Marca de Agua, Subtítulos y Conversión Vertical de Video con un Servidor MCP

¿Qué es ClipForge?

ClipForge es una API de procesamiento de video que recorta, añade marcas de agua, extrae audio de, convierte a vertical 9:16, y incrusta subtítulos SRT en cualquier video — ya sea una URL de archivo de video directo, o un enlace de YouTube y los miles de otros sitios que yt-dlp soporta. Llámala como una API REST simple desde cualquier lenguaje, o conecta el servidor MCP integrado para entregar estas operaciones directamente a Claude, Cursor o cualquier otro agente de IA compatible con MCP. Sin instalación de ffmpeg, sin servidor que ejecutar — solo una URL de entrada y algunos parámetros.

¿Qué puede hacer ClipForge?

  • Recortar — corta un video hasta un tiempo de inicio y duración exactos.
  • Extraer audio — extrae la pista de audio como MP3, con bitrate ajustable (64k-320k).
  • Marca de agua — superpone una imagen en la esquina inferior derecha de un video.
  • Convertir a vertical — reformatea un video estándar 16:9 a 9:16, con una copia desenfocada y escalada del video llenando el fondo, listo para Shorts, Reels y TikTok.
  • Superponer subtítulos — incrusta subtítulos SRT crudos directamente en una conversión de video vertical 9:16.
  • Acepta URLs de archivos multimedia directos (.mp4, .mov, etc.) y enlaces compatibles con YouTube/yt-dlp — sin necesidad de resolver previamente una URL de transmisión tú mismo.
  • Dos estilos de llamada: endpoints síncronos que transmiten el resultado directamente para clips cortos, y un endpoint de trabajo asíncrono (enviar, consultar, descargar) para fuentes más largas.
  • Se distribuye como servidor MCP, por lo que cualquier cliente MCP puede llamar a Trim, ExtractAudio, Watermark, ConvertToVertical y herramientas habilitadas para subtítulos directamente.

Ejemplos

Convertir a vertical:

ClipForge convert-vertical example: a 16:9 source video next to its 9:16 output with a blurred background fill

Marca de agua:

ClipForge watermark example: a video before and after a logo is overlaid in the bottom-right corner

¡Recuerda la plataforma Apify!

ClipForge no es solo un envoltorio de ffmpeg — viene con todo lo que la plataforma Apify te ofrece adicionalmente: facturación por evento para que solo pagues por lo que realmente procesas, un endpoint de API Standby persistente sin gestión de ejecución en frío, monitoreo de solicitudes integrado, e integración en una línea con Make, Zapier y todas las demás herramientas conectadas a Apify.

¿Cómo uso ClipForge?

Opción 1 — API REST

Cada llamada necesita tu token de API de Apify, ya sea como parámetro de consulta token o como encabezado Authorization: Bearer.

Recortar un video (síncrono, transmite el MP4 de vuelta):

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

Puedes ejecutar este Actor programáticamente usando nuestra API. A continuación hay ejemplos de código en JavaScript, Python y CLI, así como la especificación OpenAPI y la configuración del servidor MCP.

Ejemplo en 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

Ejemplo en 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

Ejemplo en CLI

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

Configuración del servidor MCP

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

El servidor alojado te inicia sesión con OAuth en la primera conexión, por lo que no se necesita ningún token de API en esta configuración. Los clientes sin soporte de OAuth pueden enviar un encabezado Authorization: Bearer <APIFY_API_TOKEN> en su lugar, usando un token de API e Integraciones en la Consola de Apify (https://console.apify.com/settings/integrations).

Especificación OpenAPI

Descarga la definición de OpenAPI: https://api.apify.com/v2/actors/Nrc1HPxDCvg0EuXnz/builds/dSOMk0wAsEs17nVHd/openapi.json