Utilisez une seule API REST pour générer des vidéos produit, des clips sociaux, des sorties personnalisées et des vidéos pilotées par agents via des schémas, aperçus, tâches formelles, rendu, fichiers et webhooks.
Passez du schéma à l’aperçu, à la tâche, au rendu et au webhook en quelques minutes.
Flux recommandé : aperçu ou création de tâche -> rendu -> polling du statut / réception du webhook
Les exemples ci-dessous montrent le parcours standard pour une intégration de type production. Cas d’usage typiques : vidéos marketing, vidéos produit, sorties d’agents IA et workflows de contenu répétables.
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
}'Interfaces clés pour les aperçus, les tâches, le rendu, les fichiers et les crédits basés sur l’usage à travers les workflows produit et automatisés.
Créez une tâche formelle traçable à partir d’un schéma sans démarrer immédiatement le rendu.
Lisez la liste des tâches de votre compte avec pagination pour les tableaux de bord et la synchronisation backend.
Retourne dimensions, durée, statut, URLs de sortie, métadonnées et principaux timestamps d’une tâche.
Supprime les enregistrements locaux de tâche et tente de nettoyer la tâche en amont.
Envoie une tâche existante au rendu. Supporte num_workers et webhook_url.
Téléversez des fichiers image, vidéo et audio pour les réutiliser dans les workflows d’aperçu et de rendu.
Parcourez la bibliothèque de fichiers avec pagination et filtres de type pour image, vidéo et audio.
Supprime les enregistrements d’assets et leurs objets stockés pour garder une bibliothèque propre.
Lisez votre solde de crédits restant avant de déclencher un rendu formel.
Générez des liens d’aperçu sans consommer de crédits de rendu formel. Les liens expirent par défaut après 7 jours.
Inspectez le schéma actuellement stocké derrière un lien d’aperçu temporaire.
Supprimez les aperçus temporaires avant leur expiration.
Clone un aperçu validé en tâche formelle sans lancer immédiatement le rendu.
Transforme directement un aperçu en tâche formelle et l’envoie immédiatement au rendu.
Lorsque vous transmettez webhook_url dans une requête de rendu, RenderingVideo envoie une requête POST à votre endpoint lorsque la tâche se termine ou échoue. Cela convient aux mises à jour de base de données, callbacks produit ou actions de suivi d’agents. Les événements actuels sont completed et failed.
{
"taskId": "abc123def456",
"renderTaskId": "rt_002",
"status": "completed",
"videoUrl": "https://storage.../videos/abc123.mp4",
"error": null,
"timestamp": "2026-03-23T10:00:00.000Z"
}Utilisez les SDK pour intégrer RenderingVideo plus rapidement dans vos services existants.
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;Toutes les requêtes API côté serveur nécessitent une clé API.
Authorization: Bearer sk-your-api-keyAuthorization: Token sk-your-api-keyX-API-Key: sk-your-api-key?api_key=sk-your-api-keyNote de sécurité : les clés API doivent rester uniquement sur votre serveur. Ne les exposez jamais dans du code client, des bundles navigateur ou des dépôts publics.
Branchez aperçus, tâches formelles, rendu et callbacks de résultat dans votre app IA, votre produit SaaS ou votre workflow d’automatisation.