Uma API de vídeo para apps de IA, automação e produtos SaaS
Use uma única API REST para gerar vídeos de produto, clipes sociais, saídas personalizadas e vídeos orientados por agentes via schemas, prévias, tarefas formais, renderização, arquivos e webhooks.
Início rápido
Vá do schema à prévia, à tarefa, ao render e ao webhook em poucos minutos.
Fluxo recomendado: preview ou criar task -> render -> consultar status / receber webhook
Exemplos de código
Os exemplos abaixo mostram o caminho padrão para integração em estilo produção. Casos de uso típicos incluem vídeos de marketing, vídeos de produto, saídas de agentes de IA e workflows de conteúdo repetíveis.
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 principais
Interfaces-chave para prévias, tarefas, renderização, arquivos e créditos por uso em workflows de produto e automação.
Crie uma tarefa formal rastreável a partir de um schema sem iniciar a renderização imediatamente.
Leia a lista de tarefas da sua conta com paginação para dashboards e sincronização de backend.
Retorna dimensões, duração, status, URLs de saída, metadados e timestamps principais de uma tarefa.
Exclui registros locais da tarefa e tenta limpar também a tarefa no serviço upstream.
Envia uma tarefa existente para renderização. Suporta num_workers e webhook_url.
Faça upload de arquivos de imagem, vídeo e áudio para reutilização em workflows de prévia e render.
Navegue pela biblioteca de arquivos com paginação e filtros por tipo para imagem, vídeo e áudio.
Remove registros de assets e objetos armazenados para manter a biblioteca limpa.
Leia seu saldo restante de créditos antes de disparar uma renderização formal.
Gere links de prévia sem consumir créditos de renderização formal. Os links expiram por padrão após 7 dias.
Inspecione o schema atualmente armazenado por trás de um link de prévia temporário.
Remova prévias temporárias antes que expirem.
Clona uma prévia validada em uma tarefa formal sem renderizar ainda.
Converte uma prévia diretamente em uma tarefa formal e a envia imediatamente para renderização.
Quando você envia webhook_url em uma requisição de render, o RenderingVideo faz uma requisição POST ao seu endpoint quando a tarefa é concluída ou falha. Isso se encaixa em atualizações de banco de dados, callbacks de produto ou ações posteriores de agentes. Os eventos atuais são completed e failed.
{
"taskId": "abc123def456",
"renderTaskId": "rt_002",
"status": "completed",
"videoUrl": "https://storage.../videos/abc123.mp4",
"error": null,
"timestamp": "2026-03-23T10:00:00.000Z"
}Ferramentas de integração
Use SDKs para integrar o RenderingVideo mais rápido aos seus serviços 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;Autenticação
Todas as requisições de API no servidor exigem uma API Key.
Header Authorization (recomendado)
Authorization: Bearer sk-your-api-keyAuthorization: Token
Authorization: Token sk-your-api-keyHeader X-API-Key
X-API-Key: sk-your-api-keyParâmetro de query (apenas debug, não para produção)
?api_key=sk-your-api-keyNota de segurança: as API Keys devem ficar apenas no seu servidor. Nunca as exponha em código cliente, bundles do navegador ou repositórios públicos.
Pronto para integrar geração de vídeo ao seu produto?
Conecte prévias, tarefas formais, renderização e callbacks de resultados ao seu app de IA, produto SaaS ou workflow de automação.