auto stud
APIVideo-Rendering-API

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.create

Drei Aufrufe, von der Timeline zur mp4

Video einmal anlegen, dann so oft rendern, wie du willst.

  1. 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. 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. 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_id

Das zu rendernde Video. Die gesamte Komposition steckt bereits darin.

render_settings

Optionale Overrides für diesen Job: Format, Qualität, der gewünschte Frame-Bereich.

Idempotency-Key

Ein Header. Schickst du denselben Key zweimal, bekommst du den ersten Render zurück, nie ein Duplikat.

render_id

Kommt 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.

portrait 9:16square 1:1landscape 16:9mp4 / H.264

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.failed

Was 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.

Sichere Zahlungen
Sofortiger Zugang
Jederzeit kündbar