APIAPI for videorendering

Render ferdig video
rett fra din egen kode

Én POST køer en rendering på våre workers, og et signert webhook gir deg mp4-filen. Ingen ffmpeg å installere, ingen GPU å leie, ingen kø å passe på.

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

Tre kall, fra tidslinje til mp4

Lag videoen én gang, og render den så mange ganger du trenger.

  1. 1

    Lag videoen

    En video bærer tidslinjen: lag, lyd, undertekster, format. Lag den i ett kall, eller gjenbruk den teamet ditt bygde i redigeringsverktøyet.

    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

    Legg renderingen i kø

    Pek renders.create mot video-id-en, overstyr det akkurat denne jobben trenger, og den går rett til en worker. Svaret er jobben, ikke filen.

    # 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

    Hent mp4-filen

    render.completed kommer med utdata-URL-en. Foretrekker stacken din polling, leser du i stedet renderingene tilbake filtrert på video-id-en.

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

Hva en rendering tar imot

To felter for å starte den, én header for trygge gjentakelser, én id for å følge den.

video_id

Videoen som skal renderes. Hele komposisjonen bor allerede i den.

render_settings

Valgfrie overstyringer for denne jobben: format, kvalitet, bildeintervallet du vil ha.

Idempotency-Key

En header. Sender du samme nøkkel to ganger, får du den første renderingen tilbake, aldri en duplikat.

render_id

Returneres av kallet og følger med hvert webhook, så en ferdig mp4 alltid peker tilbake på jobben som ba om den.

Hva som kommer ut

Renderinger er H.264-mp4 i formatet videoen er satt til. Stående for TikTok og Reels, kvadratisk for en feed, liggende for YouTube: samme tidslinje, et annet utdata.

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

Slutt å polle

En rendering tar minutter, ikke millisekunder. Registrer ett webhook, så forteller tre hendelser deg når en worker tok jobben, når filen er klar, og når noe gikk i stykker.

render.startedrender.completedrender.failed

Det utviklere spør om først

Hvor lang tid tar en rendering?

Minutter, skalert med videoens lengde og antall lag. Kallet svarer så snart jobben er i kø, så ingenting i appen din venter på den.

Hva koster en rendering?

Renderinger faktureres i kreditter, og regnskapet kan leses via API-et. En nøkkel kan begrenses til bare renders:read, så et dashbord følger forbruket uten å kunne starte jobber.

Kan jeg trygt prøve et mislykket kall på nytt?

Ja. Send en Idempotency-Key-header, så returnerer et gjentatt kall den opprinnelige renderingen i stedet for å køe en ny: samme garanti som enhver kjørende handling i API-et gir.

Hvor ligger filen?

På vårt CDN, og URL-en står både på renderingens post og i render.completed-nyttelasten. Last den ned og lagre den selv om du trenger den for alltid.

Klar til å skape?

Lag virale videoer på få minutter. Du trenger ikke kort for å prøve gratis.

Trygge betalinger
Tilgang med én gang
Avslutt når du vil