Uma infraestrutura de vídeo API para AI produtosInfraestrutura de vídeo
Use um REST API para esquemas, visualizações, tarefas, renderização, arquivos e webhooks para incorporar recursos de vídeo em seu produto e fluxos de automação.
Início rápido
Vá da visualização à tarefa, renderização e webhook em poucos minutos.
Fluxo recomendado: visualizar ou criar tarefa -> renderizar -> status da pesquisa/receber webhook
Exemplos de código
Os exemplos abaixo mostram o caminho padrão para integração no estilo de produção.
curl -X POST 'https://renderingvideo.com/api/v1/video' \
-H 'Autorização: Portador sk-sua-api-key' \
-H 'Tipo de conteúdo: aplicativo/json' \
-d '{
"configuração": {
"meta": {
"version": "2.0.0",
"width": 1920,
"height": 1080,
"fps": 30,
"background": "#000000"
},
"faixas": [
{
"clipes": [
{
"type": "text",
"text": "Hello World",
"start": 0,
"duration": 5
}
]
}
]
}
}'
curl -X POST 'https://renderingvideo.com/api/v1/video/<taskId>/render' \
-H 'Autorização: Portador sk-sua-api-key' \
-H 'Tipo de conteúdo: aplicativo/json' \
-d '{
"webhook_url": "https://your-server.com/renderingvideo-webhook",
"num_workers": 5
}'Núcleo APIs
Interfaces principais para visualizações, tarefas, renderização, arquivos e créditos baseados em uso.
Crie uma tarefa formal rastreável a partir de um esquema sem iniciar a renderização imediatamente.
Leia a lista de tarefas da sua conta com paginação para painéis e fluxos de sincronização de back-end.
Retorne dimensões, duração, status, URLs de saída, metadados e carimbos de data/hora principais para uma tarefa.
Exclua registros de tarefas locais e tente a limpeza no serviço de renderização upstream.
Envie uma tarefa existente para renderização. Suporta num_workers e webhook_url.
Carregue arquivos de imagem, vídeo e áudio para reutilização em fluxos de trabalho de visualização e renderização.
Navegue pela biblioteca de arquivos com paginação e filtros de tipo para imagem, vídeo e áudio.
Remova registros de ativos e seus objetos armazenados para manter a biblioteca limpa.
Leia o seu saldo de crédito restante antes de acionar a renderização formal.
Gere links de visualização sem consumir créditos formais de renderização. Os links de visualização expiram após 7 dias por padrão.
Inspecione o esquema atualmente armazenado atrás de um link de visualização temporário.
Remova as visualizações temporárias antes que expirem.
Clone uma visualização validada em uma tarefa formal sem renderização ainda.
Transforme uma visualização diretamente em uma tarefa formal e envie-a para renderização imediatamente.
Quando você passa webhook_url em uma solicitação de renderização, RenderingVideo envia uma solicitação POST para seu endpoint quando a tarefa é concluída ou falha. Isso se aplica a atualizações de banco de dados, retornos de chamada de produtos ou ações de acompanhamento de agentes. Os eventos atuais foram concluídos e falharam.
{
"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 conectar RenderingVideo a serviços existentes com mais rapidez.
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 solicitações API do lado do servidor requerem uma chave API.
Cabeçalho de autorização (recomendado)
Autorização: Portador sk-your-api-keyAutorização: Token
Autorização: Token sk-your-api-keyCabeçalho X-API-Key
X-API-Key: sk-sua-chave-apiParâmetro de consulta (somente depuração, não para produção)
?api_key=sk-sua-chave de APINota de segurança: as chaves API devem residir apenas no seu servidor. Nunca os exponha em código de cliente, pacotes de navegador ou repositórios públicos.
Pronto para integrar?
Conecte visualizações, tarefas formais, renderização e retornos de chamada de resultados em seu próprio produto e fluxo de trabalho.