Utilisez une API REST unique pour les schémas, les aperçus, les tâches, le rendu, les fichiers et les webhooks afin d'intégrer des capacités vidéo dans vos flux produit et d'automatisation.
Passez de 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 -> interrogation de l'état / réception du webhook
Les exemples ci-dessous illustrent le chemin standard d'une intégration de type production.
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'utilisation.
Créez une tâche formelle traçable à partir d'un schéma sans lancer immédiatement le rendu.
Consultez la liste des tâches de votre compte avec une pagination adaptée aux tableaux de bord et aux flux de synchronisation backend.
Renvoie les dimensions, la durée, le statut, les URL de sortie, les métadonnées et les horodatages clés d'une tâche.
Supprimez les enregistrements locaux de la tâche et tentez un nettoyage sur le service de rendu amont.
Envoyez une tâche existante vers le rendu. Prend en charge `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 des filtres de pagination et de type pour l'image, la vidéo et l'audio.
Supprimez les enregistrements de ressources et leurs objets stockés pour garder la bibliothèque propre.
Lisez votre solde de crédits restant avant de déclencher le rendu formel.
Générez des liens d'aperçu sans consommer de crédits de rendu formel. Les liens d'aperçu 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.
Clonez un aperçu validé en tâche formelle sans lancer le rendu tout de suite.
Transformez un aperçu directement en tâche formelle et envoyez-le immédiatement au rendu.
Lorsque vous fournissez `webhook_url` dans une requête de rendu, RenderingVideo envoie une requête POST à votre point de terminaison lorsque la tâche se termine ou échoue. Cela convient aux mises à jour de base de données, aux callbacks de produit ou aux 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 connecter RenderingVideo plus rapidement à 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 le code client, les bundles navigateur ou les dépôts publics.
Intégrez les aperçus, les tâches formelles, le rendu et les callbacks de résultat dans votre propre produit et workflow.