Fertiges Video rendern
direkt aus deinem Code
Ein POST stellt einen Render-Job auf unsere Worker, ein signierter Webhook liefert dir die mp4. Kein ffmpeg installieren, keine GPU mieten, keine Warteschlange beaufsichtigen.
POSThttps://autostud.ai/api/v1/actions/renders.createDrei Aufrufe, von der Timeline zur mp4
Video einmal anlegen, dann so oft rendern, wie du willst.
- 1
Video anlegen
Ein Video trägt die Timeline: Ebenen, Audio, Untertitel, Format. Leg es in einem Aufruf an oder nutze das, was dein Team im Editor gebaut hat.
export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # A video is the timeline. Create one, or skip this step and reuse # a video your team already built in the editor. curl -X POST https://autostud.ai/api/v1/actions/videos.create \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_name": "Launch teaser", "video_format": "portrait", "video_lang": "en" }' - 2
Render einreihen
Richte renders.create auf die Video-ID, überschreibe, was dieser Job braucht, und er geht sofort an einen Worker. Die Antwort ist der Job, nicht die Datei.
# The Idempotency-Key makes this call safe to retry: send it twice # and you get the same render back, never a second job. curl -X POST https://autostud.ai/api/v1/actions/renders.create \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: launch-teaser-v3" \ -d '{ "video_id": "0f4c8b71-2d95-47a3-9e6c-15b8ad7f3c20", "render_settings": { "quality": "high" } }' - 3
mp4 abholen
render.completed kommt mit der Ausgabe-URL. Wenn dein Stack lieber pollt, liest du die Renders stattdessen gefiltert nach der Video-ID zurück.
# Register once. Every render reports itself from then on. curl -X POST https://autostud.ai/api/v1/webhooks \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-app.com/hooks/autostud", "events": ["render.started", "render.completed", "render.failed"], "description": "Rendering" }' # The signing secret comes back once, in this response. Store it.
Was ein Render annimmt
Zwei Felder zum Starten, ein Header für sicheres Wiederholen, eine ID zum Nachverfolgen.
video_idDas zu rendernde Video. Die gesamte Komposition steckt bereits darin.
render_settingsOptionale Overrides für diesen Job: Format, Qualität, der gewünschte Frame-Bereich.
Idempotency-KeyEin Header. Schickst du denselben Key zweimal, bekommst du den ersten Render zurück, nie ein Duplikat.
render_idKommt aus dem Aufruf und steckt in jedem Webhook, damit eine fertige mp4 immer auf ihren Job zurückzeigt.
Was herauskommt
Renders sind H.264-mp4 in dem Format, das am Video eingestellt ist. Hochkant für TikTok und Reels, quadratisch für den Feed, quer für YouTube: dieselbe Timeline, eine andere Ausgabe.
Schluss mit Polling
Ein Render dauert Minuten, keine Millisekunden. Registriere einen Webhook, und drei Events sagen dir, wann ein Worker den Job genommen hat, wann die Datei fertig ist und wann etwas kaputtging.
render.startedrender.completedrender.failedWas Entwickler zuerst fragen
Wie lange dauert ein Render?
Minuten, skalierend mit Videolänge und Anzahl der Ebenen. Der Aufruf antwortet, sobald der Job in der Warteschlange steht, also blockiert in deiner App nichts.
Was kostet ein Render?
Renders werden in Credits abgerechnet, und das Ledger ist über die API lesbar. Ein Key kann auf renders:read allein beschränkt werden, damit ein Dashboard die Ausgaben verfolgt, ohne Jobs starten zu können.
Kann ich einen fehlgeschlagenen Aufruf gefahrlos wiederholen?
Ja. Schick einen Idempotency-Key-Header, und ein wiederholter Aufruf gibt den ursprünglichen Render zurück, statt einen zweiten einzureihen: dieselbe Garantie wie bei jeder Execute-Action der API.
Wo liegt die Datei?
Auf unserem CDN, und die URL steht im Render-Datensatz und im render.completed-Payload. Lade sie herunter und speichere sie selbst, wenn du sie dauerhaft brauchst.
Bereit zu erstellen?
Beginnen Sie in Minuten mit der Generierung viraler Videos. Keine Kreditkarte für die kostenlose Testversion erforderlich.