APIVideo Rendering API

Render de afgewerkte video
rechtstreeks vanuit je code

Eén POST zet een render in de wachtrij op onze workers en een ondertekende webhook geeft je de mp4. Geen ffmpeg installeren, geen GPU huren, geen wachtrij bewaken.

POSThttps://autostud.ai/api/v1/actions/renders.create

Drie calls, van tijdlijn naar mp4

Maak de video één keer aan en render hem zo vaak je wilt.

  1. 1

    Maak de video aan

    Een video draagt de tijdlijn: lagen, audio, ondertitels, formaat. Maak hem in één call aan of hergebruik wat je team in de editor bouwde.

    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

    Zet de render in de wachtrij

    Richt renders.create op het video-id, overschrijf wat deze job nodig heeft, en hij gaat meteen naar een worker. Het antwoord is de job, niet het bestand.

    # 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

    Haal de mp4 op

    render.completed komt binnen met de output-URL. Verkiest je stack polling, lees de renders dan terug gefilterd op het video-id.

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

Wat een render aanneemt

Twee velden om te starten, één header om veilig opnieuw te proberen, één id om te volgen.

video_id

De video die gerenderd wordt. De hele compositie zit er al in.

render_settings

Optionele overrides voor deze job: formaat, kwaliteit, het frame-bereik dat je wilt.

Idempotency-Key

Een header. Stuur dezelfde sleutel twee keer en je krijgt de eerste render terug, nooit een duplicaat.

render_id

Komt uit de call en reist mee in elke webhook, zodat een afgewerkte mp4 altijd naar zijn job terugwijst.

Wat eruit komt

Renders zijn H.264-mp4 in het formaat dat op de video staat. Verticaal voor TikTok en Reels, vierkant voor een feed, liggend voor YouTube: dezelfde tijdlijn, een andere output.

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

Stop met pollen

Een render duurt minuten, geen milliseconden. Registreer één webhook en drie events vertellen je wanneer een worker de job oppakte, wanneer het bestand klaar is en wanneer er iets brak.

render.startedrender.completedrender.failed

Wat ontwikkelaars het eerst vragen

Hoe lang duurt een render?

Minuten, meeschalend met de lengte van de video en het aantal lagen. De call antwoordt zodra de job in de wachtrij staat, dus niets in je app blijft wachten.

Wat kost een render?

Renders worden in credits afgerekend en het grootboek is via de API leesbaar. Een sleutel kan alleen renders:read krijgen, zodat een dashboard de uitgaven volgt zonder jobs te kunnen starten.

Kan ik een mislukte call veilig opnieuw sturen?

Ja. Stuur een Idempotency-Key-header en een herhaalde call geeft de oorspronkelijke render terug in plaats van een tweede in de wachtrij te zetten, dezelfde garantie als bij elke execute-actie van de API.

Waar staat het bestand?

Op ons CDN, en de URL staat op het render-record en in de render.completed-payload. Download hem en bewaar hem zelf als je hem voor altijd nodig hebt.

Klaar om te maken?

Maak virale video's in enkele minuten. Geen creditcard nodig voor de gratis proefperiode.

Veilig betalen
Direct toegang
Altijd opzegbaar