Una infraestructura de vídeo API para AI productosInfraestructura de vídeo
Utilice un REST API para esquemas, vistas previas, tareas, renderizado, archivos y webhooks para incorporar capacidades de video en su producto y flujos de automatización.
Inicio rápido
Pase de la vista previa a la tarea, el renderizado y el webhook en unos minutos.
Flujo recomendado: vista previa o creación de tarea -> renderizar -> estado de la encuesta/recibir webhook
Ejemplos de código
Los siguientes ejemplos muestran la ruta estándar para la integración de estilo de producción.
curl -X POST 'https://renderingvideo.com/api/v1/video' \
-H 'Autorización: Portador sk-your-api-key' \
-H 'Tipo de contenido: aplicación/json' \
-d '{
"configuración": {
"meta": {
"version": "2.0.0",
"width": 1920,
"height": 1080,
"fps": 30,
"background": "#000000"
},
"pistas": [
{
"clips": [
{
"type": "text",
"text": "Hello World",
"start": 0,
"duration": 5
}
]
}
]
}
}'
curl -X POST 'https://renderingvideo.com/api/v1/video/<taskId>/render' \
-H 'Autorización: Portador sk-your-api-key' \
-H 'Tipo de contenido: aplicación/json' \
-d '{
"webhook_url": "https://your-server.com/renderingvideo-webhook",
"num_workers": 5
}'Núcleo APIs
Interfaces clave para vistas previas, tareas, renderizado, archivos y créditos basados en el uso.
Cree una tarea formal rastreable a partir de un esquema sin comenzar a renderizar inmediatamente.
Lea la lista de tareas de su cuenta con paginación para paneles y flujos de sincronización de backend.
Devuelve dimensiones, duración, estado, URL de salida, metadatos y marcas de tiempo clave para una tarea.
Elimine los registros de tareas locales e intente realizar la limpieza en el servicio de representación ascendente.
Envíe una tarea existente a renderizado. Admite num_workers y webhook_url.
Cargue archivos de imagen, vídeo y audio para reutilizarlos en flujos de trabajo de vista previa y renderizado.
Explore la biblioteca de archivos con filtros de paginación y tipo para imágenes, videos y audio.
Elimine los registros de activos y sus objetos almacenados para mantener limpia la biblioteca.
Lea su saldo de crédito restante antes de activar la prestación formal.
Genere enlaces de vista previa sin consumir créditos de renderizado formales. Los enlaces de vista previa caducan después de 7 días de forma predeterminada.
Inspeccione el esquema almacenado actualmente detrás de un enlace de vista previa temporal.
Elimine las vistas previas temporales antes de que caduquen.
Clona una vista previa validada en una tarea formal sin renderizar todavía.
Convierta una vista previa directamente en una tarea formal y envíela a renderizado inmediatamente.
Cuando pasa webhook_url en una solicitud de procesamiento, RenderingVideo envía una solicitud POST a su punto final cuando la tarea se completa o falla. Esto se adapta a actualizaciones de bases de datos, devoluciones de llamadas de productos o acciones de seguimiento de agentes. Los acontecimientos actuales se completan y fracasan.
{
"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
Utilice SDKs para conectar RenderingVideo a servicios existentes más rápido.
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 del servidor requieren una clave API.
Encabezado de autorización (recomendado)
Autorización: Portador sk-your-api-keyAutorización: Ficha
Autorización: Token sk-your-api-keyX-API-Encabezado clave
X-API-Clave: sk-tu-clave-apiParámetro de consulta (solo depuración, no para producción)
?api_key=sk-tu-clave-apiNota de seguridad: las claves API deben residir únicamente en su servidor. Nunca los exponga en código de cliente, paquetes de navegador o repositorios públicos.
¿Listo para integrarse?
Conecte vistas previas, tareas formales, renderizado y devoluciones de llamadas de resultados a su propio producto y flujo de trabajo.