Eine Video-Infrastruktur-API für KI-Produkte
Verwenden Sie eine REST-API für Schemata, Vorschauen, Aufgaben, Rendering, Dateien und Webhooks, um Videofunktionen in Ihr Produkt und Ihre Automatisierungsflüsse einzubetten.
Schnellstart
Gehen Sie in wenigen Minuten von Vorschau zu Aufgabe, Rendering und Webhook.
Empfohlener Ablauf: Vorschau oder Aufgabe erstellen -> rendern -> Status abfragen / Webhook empfangen
Code-Beispiele
Die Beispiele unten zeigen den Standardweg für eine produktionsnahe Integration.
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
}'Kern-APIs
Wichtige Schnittstellen für Vorschauen, Aufgaben, Rendering, Dateien und nutzungsbasierte Credits.
Erstellen Sie aus einem Schema eine nachvollziehbare formale Aufgabe, ohne das Rendering sofort zu starten.
Lesen Sie die Aufgabenliste Ihres Kontos mit Paginierung für Dashboards und Backend-Synchronisationsflüsse.
Gibt Abmessungen, Dauer, Status, Ausgabe-URLs, Metadaten und wichtige Zeitstempel für eine Aufgabe zurück.
Löschen Sie lokale Aufgabendatensätze und versuchen Sie eine Bereinigung beim nachgelagerten Rendering-Dienst.
Senden Sie eine bestehende Aufgabe ins Rendering. Unterstützt `num_workers` und `webhook_url`.
Laden Sie Bild-, Video- und Audiodateien hoch, um sie in Vorschau- und Rendering-Workflows wiederzuverwenden.
Durchsuchen Sie die Dateibibliothek mit Paginierung und Typfiltern für Bild, Video und Audio.
Entfernen Sie Asset-Datensätze und die gespeicherten Objekte, damit die Bibliothek sauber bleibt.
Lesen Sie Ihr verbleibendes Credit-Guthaben, bevor Sie ein formales Rendering starten.
Erzeugen Sie Vorschau-Links, ohne formale Render-Credits zu verbrauchen. Vorschau-Links laufen standardmäßig nach 7 Tagen ab.
Sehen Sie sich das Schema an, das aktuell hinter einem temporären Vorschau-Link gespeichert ist.
Entfernen Sie temporäre Vorschauen, bevor sie ablaufen.
Klonen Sie eine validierte Vorschau in eine formale Aufgabe, ohne sie sofort zu rendern.
Wandeln Sie eine Vorschau direkt in eine formale Aufgabe um und starten Sie sie sofort im Rendering.
Wenn Sie bei einer Render-Anfrage `webhook_url` übergeben, sendet RenderingVideo beim Abschluss oder Fehlschlag der Aufgabe eine POST-Anfrage an Ihren Endpunkt. Das passt zu Datenbank-Updates, Produkt-Callbacks oder Folgeaktionen von Agenten. Die aktuellen Ereignisse sind `completed` und `failed`.
{
"taskId": "abc123def456",
"renderTaskId": "rt_002",
"status": "completed",
"videoUrl": "https://storage.../videos/abc123.mp4",
"error": null,
"timestamp": "2026-03-23T10:00:00.000Z"
}Integrations-Tools
Verwenden Sie SDKs, um RenderingVideo schneller in bestehende Dienste einzubinden.
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;Authentifizierung
Alle serverseitigen API-Anfragen benötigen einen API-Key.
Authorization Header (empfohlen)
Authorization: Bearer sk-your-api-keyAuthorization: Token
Authorization: Token sk-your-api-keyX-API-Key Header
X-API-Key: sk-your-api-keyQuery-Parameter (nur Debugging, nicht für Produktion)
?api_key=sk-your-api-keySicherheitshinweis: API-Keys gehören nur auf Ihren Server. Geben Sie sie niemals in Client-Code, Browser-Bundles oder öffentlichen Repositories preis.
Bereit zur Integration?
Binden Sie Vorschauen, formale Aufgaben, Rendering und Ergebnis-Callbacks in Ihr eigenes Produkt und Ihren Workflow ein.