Die Video-API, die Creatomate spricht.
Eine Anfrage mit Vorlage und Daten, eine Datei-URL zurück. Die Routen sind mit Creatomate kompatibel, dazu gibt es eine native API mit OpenAPI-Beschreibung, Idempotenz und klaren Fehlermeldungen.
Video-API
Was dazugehört
MP4, GIF, PNG, JPG
Bis 4K und 60 fps, je nach Tarif. Für Videos auf Wunsch ein Vorschaubild zum gewünschten Zeitpunkt.
Mehrere Varianten in einem Aufruf
Über /v1/renders mit Tags oder Listen rendern Sie mehrere Varianten auf einmal, jede mit eigener Datei.
dry_run und strict
dry_run prüft die Anfrage und schätzt Credits, ohne zu rendern. strict macht aus Warnungen Fehler, etwa bei Tippfehlern in Feldnamen.
Signierte Webhooks
HMAC-SHA256 im Header Agile-Signature, Wiederholungen mit wachsender Wartezeit, Zustellprotokoll im Konto.
Datei-URL sofort
Die URL /f/<id>.mp4 steht beim Anlegen fest und liefert ab Fertigstellung, mit Range-Requests für Video-Player.
OpenAPI 3.1 und interaktive Doku
Alle Endpunkte zum Ausprobieren unter /docs, maschinenlesbar unter /api/openapi.json. Idempotency-Key für sichere Wiederholungen.
Beispiel
So sieht das im Code aus
# Video aus einer Vorlage rendern (wie bei Creatomate)
curl -X POST https://render.agiledeveloper.de/v2/renders \
-H "Authorization: Bearer agile_render_…" \
-H "Content-Type: application/json" \
-d '{
"template_id": "c2d6b7e4-5f1a-4b3e-9a2d-1e8f7c6b5a40",
"modifications": {
"Titel": "Herbst-Kollektion 2026",
"Preis": "ab 49 €",
"Produktbild": "https://shop.example/jacke.jpg"
},
"webhook_url": "https://ihr-server.de/render-fertig"
}'const res = await fetch('https://render.agiledeveloper.de/v2/renders', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.AGILE_RENDER_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
template_id: 'c2d6b7e4-5f1a-4b3e-9a2d-1e8f7c6b5a40',
modifications: { Titel: 'Herbst-Kollektion 2026', Preis: 'ab 49 €' },
}),
});
const render = await res.json();
console.log(render.status, render.url);
// planned https://render.agiledeveloper.de/f/<id>.mp4# 202 Accepted: die Datei-URL steht sofort fest
{
"id": "8f0c…",
"status": "planned",
"url": "https://render.agiledeveloper.de/f/8f0c….mp4",
"progress": 0,
"output_format": "mp4",
"template_id": "c2d6b7e4-…"
}
# Danach POST an Ihre webhook_url, signiert
Agile-Signature: t=1760000000,v1=HMAC-SHA256// Webhook prüfen: HMAC-SHA256 über "<t>.<Rohtext>" mit Ihrem Webhook-Geheimnis
import crypto from 'node:crypto';
function echt(roh, kopf, geheimnis) {
const { t, v1 } = Object.fromEntries(kopf.split(',').map((x) => x.split('=')));
const soll = crypto.createHmac('sha256', geheimnis).update(`${t}.${roh}`).digest('hex');
return crypto.timingSafeEqual(Buffer.from(soll), Buffer.from(v1));
}Wie schnell ist ein Render fertig?
Das hängt von Länge, Auflösung und Medien ab. Bilder sind meist in wenigen Sekunden fertig, Videos brauchen je nach Länge länger. Den Fortschritt sehen Sie im Feld progress, das Ende meldet der Webhook.
Gibt es SDKs?
Die API ist schlichtes JSON über HTTPS, jede HTTP-Bibliothek reicht. Weil die Routen mit Creatomate kompatibel sind, funktionieren auch viele bestehende Creatomate-Clients, wenn Sie die Basis-URL ändern. Für die Vorschau im Browser gibt es das Preview SDK.
Wie viele Anfragen darf ich senden?
Bis zu 120 Anfragen pro Minute je API-Schlüssel. Wie viele Renders gleichzeitig laufen, richtet sich nach dem Tarif; weitere warten in der Warteschlange.
Weitere Funktionen
Das gehört auch dazu
Probieren Sie es mit Ihren eigenen Daten.
Kostenlos registrieren, Startvorlage wählen oder importieren, rendern.
50 Credits im Monat gratis · Keine Kreditkarte · Jederzeit kündbar