APIAPI til videorendering

Render den færdige video
direkte fra din egen kode

Ét POST sætter en rendering i kø på vores workers, og et signeret webhook rækker dig mp4-filen. Ingen ffmpeg at installere, ingen GPU at leje, ingen kø at holde øje med.

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

Tre kald, fra tidslinje til mp4

Opret videoen én gang, og render den så mange gange du har brug for.

  1. 1

    Opret videoen

    En video bærer tidslinjen: lag, lyd, undertekster, format. Opret den i ét kald, eller genbrug den, dit team byggede i editoren.

    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

    Sæt renderingen i kø

    Peg renders.create på video-id, overskriv det, netop dette job kræver, og det går straks til en worker. Svaret er jobbet, 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 ankommer med output-URL-en. Foretrækker din stack polling, læser du i stedet renderingerne tilbage filtreret på 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.

Hvad en rendering tager imod

To felter til at starte den, én header til sikre gentagelser, ét id til at følge den.

video_id

Videoen der skal renderes. Hele kompositionen bor allerede i den.

render_settings

Valgfrie tilsidesættelser for dette job: format, kvalitet, det billedinterval du vil have.

Idempotency-Key

En header. Send den samme nøgle to gange, og du får den første rendering tilbage, aldrig en dublet.

render_id

Returneres af kaldet og følger med hvert webhook, så en færdig mp4 altid peger tilbage på det job, der bad om den.

Hvad der kommer ud

Renderinger er H.264-mp4 i det format, videoen er sat til. Stående til TikTok og Reels, kvadratisk til et feed, liggende til YouTube: samme tidslinje, et andet output.

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

Stop med at polle

En rendering tager minutter, ikke millisekunder. Registrér ét webhook, og tre hændelser fortæller dig, hvornår en worker tog jobbet, hvornår filen er klar, og hvornår noget gik galt.

render.startedrender.completedrender.failed

Det udviklere spørger om først

Hvor lang tid tager en rendering?

Minutter, skaleret efter videoens længde og antallet af lag. Kaldet svarer, så snart jobbet er i kø, så intet i din app venter på det.

Hvad koster en rendering?

Renderinger afregnes i kreditter, og regnskabet kan læses via API-et. En nøgle kan begrænses til renders:read alene, så et dashboard følger forbruget uden at kunne starte job.

Kan jeg trygt gentage et mislykket kald?

Ja. Send en Idempotency-Key-header, så returnerer et gentaget kald den oprindelige rendering i stedet for at sætte en ny i kø: den samme garanti, som enhver eksekverende handling i API-et giver.

Hvor ligger filen?

På vores CDN, og URL-en står både på renderingens post og i render.completed-payloaden. Hent den og gem den selv, hvis du skal have den for altid.

Klar til at skabe?

Lav virale videoer på få minutter. Der skal ikke kort til for at prøve gratis.

Sikker betaling
Adgang med det samme
Opsig når du vil