Una API de vídeo para apps de IA, automatización y productos SaaS
Usa una sola API REST para generar videos de producto, clips sociales, salidas personalizadas y videos impulsados por agentes mediante esquemas, vistas previas, tareas formales, renderizado, archivos y webhooks.
Inicio rápido
Pasa del esquema a la vista previa, la tarea, el render y el webhook en pocos minutos.
Flujo recomendado: preview o crear task -> render -> consultar estado / recibir webhook
Ejemplos de código
Los ejemplos de abajo muestran la ruta estándar para una integración tipo producción. Casos de uso habituales: vídeos de marketing, vídeos de producto, salidas de agentes de IA y workflows de contenido repetibles.
curl -X POST 'https://renderingvideo.com/api/v1/video' \
-H 'Authorization: Bearer sk-your-api-key' \
-H 'Content-Type: application/json' \
-d '{
"config": {
"meta": {
"version": "2.0.0",
"width": 1920,
"height": 1080,
"fps": 30,
"background": "#000000"
},
"tracks": [
{
"clips": [
{
"type": "text",
"text": "Hello World",
"start": 0,
"duration": 5
}
]
}
]
}
}'
curl -X POST 'https://renderingvideo.com/api/v1/video/<taskId>/render' \
-H 'Authorization: Bearer sk-your-api-key' \
-H 'Content-Type: application/json' \
-d '{
"webhook_url": "https://your-server.com/renderingvideo-webhook",
"num_workers": 5
}'APIs principales
Interfaces clave para vistas previas, tareas, renderizado, archivos y créditos por uso en flujos de producto y automatización.
Crea una tarea formal y trazable a partir de un esquema sin iniciar el render inmediatamente.
Lee la lista de tareas de tu cuenta con paginación para dashboards y sincronización backend.
Devuelve dimensiones, duración, estado, URLs de salida, metadatos y marcas de tiempo clave de una tarea.
Elimina registros locales de la tarea e intenta limpiar también la tarea upstream.
Envía una tarea existente al renderizado. Soporta num_workers y webhook_url.
Sube archivos de imagen, vídeo y audio para reutilizarlos en flujos de preview y render.
Navega por la biblioteca de archivos con paginación y filtros de tipo para imagen, vídeo y audio.
Elimina registros de assets y objetos almacenados para mantener limpia la biblioteca.
Lee tu saldo restante de créditos antes de disparar un render formal.
Genera enlaces de preview sin consumir créditos de render formal. Los enlaces expiran por defecto a los 7 días.
Inspecciona el esquema almacenado actualmente detrás de un enlace de preview temporal.
Elimina previews temporales antes de que caduquen.
Clona una preview validada en una tarea formal sin renderizar todavía.
Convierte una preview directamente en una tarea formal y la envía inmediatamente al render.
Cuando envías webhook_url en una solicitud de render, RenderingVideo hace una petición POST a tu endpoint cuando la tarea se completa o falla. Esto encaja con actualizaciones de base de datos, callbacks del producto o acciones posteriores de agentes. Los eventos actuales son completed y failed.
{
"taskId": "abc123def456",
"renderTaskId": "rt_002",
"status": "completed",
"videoUrl": "https://storage.../videos/abc123.mp4",
"error": null,
"timestamp": "2026-03-23T10:00:00.000Z"
}Herramientas de integración
Usa SDKs para integrar RenderingVideo más rápido en tus servicios existentes.
import { RenderingVideo } from '@renderingvideo/sdk';
const client = new RenderingVideo({ apiKey: 'sk-xxx' });
const task = await client.video.create({
meta: {
version: '2.0.0',
width: 1920,
height: 1080,
fps: 30,
background: '#000000',
},
tracks: [...],
});
const render = await client.video.render(task.taskId, {
webhook_url: 'https://your-server.com/renderingvideo-webhook',
});
console.log(render.status);from renderingvideo import Client
client = Client(api_key="sk-xxx")
task = client.video.create({
"meta": {
"version": "2.0.0",
"width": 1920,
"height": 1080,
"fps": 30,
"background": "#000000"
},
"tracks": [...]
})
render = client.video.render(
task.task_id,
webhook_url="https://your-server.com/renderingvideo-webhook"
)
print(render.status)use RenderingVideo\Client;
$client = new Client('sk-xxx');
$task = $client->video->create([
'meta' => [
'version' => '2.0.0',
'width' => 1920,
'height' => 1080,
'fps' => 30,
'background' => '#000000'
],
'tracks' => [...]
]);
$render = $client->video->render(
$task->task_id,
['webhook_url' => 'https://your-server.com/webhook']
);
echo $render->status;Autenticación
Todas las solicitudes API del lado servidor requieren una API Key.
Cabecera Authorization (recomendado)
Authorization: Bearer sk-your-api-keyAuthorization: Token
Authorization: Token sk-your-api-keyCabecera X-API-Key
X-API-Key: sk-your-api-keyParámetro de consulta (solo depuración, no producción)
?api_key=sk-your-api-keyNota de seguridad: las API Keys deben vivir solo en tu servidor. Nunca las expongas en código cliente, bundles del navegador o repositorios públicos.
¿Listo para integrar generación de vídeo en tu producto?
Conecta previews, tareas formales, renderizado y callbacks de resultados en tu app de IA, producto SaaS o workflow de automatización.