Función

API para recortar videos: convierte videos largos en Shorts desde tu código

Q: ¿StoryCut tiene una API?

Sí. La API REST de StoryCut inicia procesamientos de AI Clips a partir de un enlace de YouTube, muestra los clips con sus puntuaciones de viralidad y los exporta en MP4. También envía webhooks firmados al completar cada paso. Está incluida en los planes Starter, Pro y Business.

Q: ¿Cuánto cuesta la API?

No pagas nada adicional a tu plan, desde $7/mo con facturación anual. Cada procesamiento consume uno de los videos mensuales de AI Clips de tu plan: 10 en Starter, 50 en Pro y 100 en Business. No hay cargos por minuto ni por solicitud. El plan gratuito no incluye la API.

Q: ¿Qué videos puedo enviar?

Enlaces públicos de YouTube a videos de 2 a 150 minutos. No se pueden procesar videos privados, exclusivos para miembros ni con restricción de edad. Para crear clips a partir de un archivo de tu computadora, súbelo desde el sitio web.

Q: ¿Cuánto tarda un proceso?

Un video largo tarda entre 10 y 15 minutos. Añade un webhook para recibir una notificación cuando se complete run.completed o consulta GET /v1/runs/{id}, que también muestra el progreso en %.

Q: ¿Qué devuelve la API?

Para cada clip: su id, título, descripción, puntuación de viralidad sobre 100, inicio y final en el video original, duración, enlace de vista previa y enlace para editarlo en StoryCut. La exportación genera un MP4 en 9:16 de hasta 1080p, sin marca de agua.

Q: ¿Cómo verifico que un webhook proviene de StoryCut?

Cada webhook incluye un encabezado X-StoryCut-Signature: sha256= seguido del HMAC-SHA256 del cuerpo sin procesar de la solicitud, generado con el secreto de tu webhook. Calcula el mismo valor en tu servidor y compáralo. Responde con un estado 2xx en un plazo de 10 segundos; si no, StoryCut lo vuelve a intentar después de 10 segundos y de 1 minuto.

Q: ¿Puedo editar un clip antes de exportarlo?

Sí. Abre el enlace de edición del clip en el editor de StoryCut, modifica los subtítulos o añade zoom, música o efectos de sonido. La próxima exportación a través de la API incluirá esos cambios.

Q: ¿Hay límites de solicitudes?

120 solicitudes por minuto por clave de API. Los procesamientos están limitados por la cantidad mensual de videos de AI Clips de tu plan; GET /v1/usage te indica cuántos te quedan.

Q: ¿Cómo se compara con las APIs de OpusClip, Submagic y Vizard?

Todas crean clips a partir de un enlace de YouTube. La API de StoryCut cuesta desde $9/mo ($7/mo con facturación anual) y cuenta ejecuciones, no minutos: un podcast de 90 minutos cuenta como uno de los videos mensuales de tu plan. Al 21 de octubre de 2026, la API de OpusClip está disponible en su plan Pro ($29 al mes o $14.50 con facturación anual), con hasta 15 horas de creación de clips mediante API al mes; Submagic incluye de 10 a 100 minutos de API al mes, con paquetes desde $57; y Vizard usa los minutos de carga de tu plan. La tabla de arriba enlaza a cada fuente.

Q: ¿OpusClip tiene una API?

Sí. Según la documentación de OpusClip (consultada el 21 de octubre de 2026), el acceso a la API está disponible en sus planes Pro (beta), Max y Business. Se factura en créditos de un minuto cada uno, con un mínimo de 10 créditos por proyecto. La API de StoryCut está incluida desde el plan Starter, por $7/mo con facturación anual.

Envía un enlace de YouTube. StoryCut encuentra los mejores momentos, los adapta a 9:16 alrededor de quien habla, añade subtítulos animados y puntúa cada clip. Consulta los clips, expórtalos como MP4 y recibe un webhook al completarse cada paso.

Obtén tu clave de API

Incluida en Starter, Pro y Business
Sin cargos por minuto en la API
Webhooks firmados

Actualizado el 21 de octubre de 2026

La API de StoryCut: datos clave

Qué hace: Convierte un video de YouTube en hasta 12 clips verticales, cada uno con subtítulos animados, un título y una puntuación de viralidad de 0 a 100. Después, exporta cualquier clip como MP4.
Entrada: Un enlace público de YouTube de entre 2 y 150 minutos (si el video es más largo, se usan sus primeros 150 minutos). Duración del clip: corto (15–30 s), mediano (30–59 s) o largo (60–89 s).
Resultado: JSON con el título, la puntuación, el inicio y el final de cada clip, además de un enlace de vista previa y un enlace de edición. Los clips se exportan como MP4 en formato 9:16, hasta 1080p y sin marca de agua, con un enlace de descarga válido durante 24 horas.
Webhooks: run.completed, run.failed, export.completed y export.failed, cada uno firmado con HMAC-SHA256. Hasta 5 endpoints por cuenta.
Precio: Incluida en Starter ($7/mo billed yearly), Pro y Business. Cada ejecución usa uno de los videos mensuales de AI Clips incluidos en el plan: 10, 50 o 100. Sin cargos por minuto.
Límites: 120 solicitudes por minuto por clave de API. Una ejecución tarda entre 10 y 15 minutos.

Qué hace la API de StoryCut

La API usa el mismo motor de AI Clips que el sitio web de StoryCut. Envías un enlace de YouTube y la IA analiza la transcripción, elige los momentos con un inicio potente y una idea completa, adapta cada clip al formato vertical centrándolo en los rostros y en quien está hablando, añade subtítulos animados y le asigna una puntuación de viralidad. Tu código consulta los clips, ordenados de mejor a peor, y exporta los que quiera.

Todo se guarda en tu cuenta de StoryCut. Cada clip también incluye un enlace de edición: ábrelo en el editor de StoryCut para cambiar el estilo de los subtítulos o añadir zooms, música o efectos de sonido. La próxima exportación desde la API incluirá esos cambios.

Para desarrolladores

De un enlace de YouTube a un MP4 en tres llamadas

Envía tu clave de API como token Bearer. Todas las respuestas están en JSON; los errores se devuelven como { "error": { "code", "message" } } con el estado 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. Encuentra la documentación completa, tus claves y tus webhooks en StoryCut, en API & Integrations.

Endpoints

POST /v1/runs

Inicia una ejecución a partir de un enlace de YouTube y con la duración de clip que quieras. Devuelve de inmediato el ID de la ejecución.

GET /v1/runs/{id}

Estado de la ejecución (processing, completed o failed), progreso en % y número de clips.

GET /v1/runs/{id}/clips

Clips ordenados de mejor a peor: título, puntuación, inicio y final, enlace de vista previa y enlace de edición.

POST /v1/clips/{id}/export

Exporta un clip con sus subtítulos y los cambios guardados. GET /v1/exports/{id} devuelve el enlace de descarga.

Webhooks

Cuando una ejecución o exportación termina o falla, StoryCut envía un POST firmado a tu servidor, para que no tengas que estar consultando el estado.

GET /v1/usage

Tu plan y lo que te queda este mes, para que un script pueda detenerse antes de alcanzar el límite.

Tu código

Tu código inicia la ejecución. Un webhook te avisa cuando termina.

Una ejecución tarda entre 10 y 15 minutos, así que no tienes que esperar. Configura un webhook y StoryCut avisará a tu servidor con run.completed cuando los clips estén listos. Cuando un clip se haya renderizado, recibirás export.completed con el enlace de descarga. Cada solicitud se firma con el secreto de tu webhook para que tu servidor pueda comprobar que viene de StoryCut.

Código que inicia una ejecución de StoryCut y gestiona sus webhooks, junto a los clips terminados con sus puntuaciones de viralidad y un evento export.completed con un enlace de descarga

Cómo funciona

Cómo empezar con la API

01
Crea una clave
Con un plan Starter, Pro o Business, ve a API & Integrations en StoryCut y haz clic en Create key. La clave se muestra una sola vez: guárdala en el entorno de tu servidor.
02
Inicia una ejecución
Envía POST /v1/runs con un enlace de YouTube. La respuesta devuelve de inmediato el ID de la ejecución.
03
Obtén los clips
Espera el webhook run.completed o consulta GET /v1/runs/{id}. Después, consulta los clips, ordenados de mejor a peor.
04
Exporta
Envía POST /v1/clips/{id}/export. Recibirás el enlace de descarga con export.completed o mediante GET /v1/exports/{id}.

Qué puedes automatizar

Flujos de trabajo para podcasts y webinars

Se publica un episodio nuevo, tu script envía el enlace y los mejores clips están listos unos 15 minutos después.

Flujos de trabajo con n8n y Make

Llama a la API desde un paso de solicitud HTTP y empieza el siguiente paso desde el webhook: sin necesidad de alojar código.

Agencias

Procesa todos los videos de tus clientes con los mismos pasos y abre un clip en el editor de StoryCut cuando necesite un toque humano.

Asistentes de IA

¿Prefieres pedirlo por chat? Puedes iniciar las mismas ejecuciones desde Claude o ChatGPT con el conector MCP de StoryCut, en cualquier plan.

Comparativa de API para recortar videos

Comparativa de APIs para crear clips: precios, uso, webhooks y límites, según las páginas de precios y la documentación de cada herramienta, consultadas el 2026-10-21
Función	StoryCut	OpusClip	Submagic	Vizard	Klap
API incluida desde	Starter: $9/mo ($7/mo con facturación anual)	Pro: $29/mo ($14.50/mo con facturación anual)	Starter: $19/mo ($12/mo con facturación anual)	Creator: $29/mo ($14.50/mo con facturación anual)	Pago por uso: $0.32 por clip, $0.44 por video, $0.48 por exportación
Cómo se contabiliza el uso de la API	Procesamientos: los 10, 50 o 100 videos largos al mes de tu plan, de hasta 150 min cada uno	Créditos: 1 por minuto, mínimo de 10 por proyecto; hasta 15 horas al mes en Pro	De 10 a 100 minutos de API al mes; luego, paquetes desde $57 por 250 minutos	Minutos de carga de tu plan, 1 crédito por minuto (600 al mes en Creator)	Por operación
Clips a partir de un enlace de YouTube	Sí	Sí	Sí	Sí	Sí
Webhooks	Sífirmado con HMAC-SHA256	Sífirmado	Sí	Síconfigurado en el espacio de trabajo	Nola documentación indica que se consulta el estado
Límite de solicitudes	120 solicitudes por minuto	30 solicitudes por minuto	Nose especifica	3 por minuto en Creator	Nose especifica
Conector para Claude y ChatGPT (MCP)	Sítodos los planes	Sí	Sí	Noverificado	Noverificado