API視頻渲染 API

把成片渲染出來
直接從你的代碼裡

一次 POST 就把渲染任務排進我們的工作節點，簽名 Webhook 把 mp4 交給你。不用裝 ffmpeg，不用租 GPU，也不用盯著隊列。

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

三次調用，從時間軸到 mp4

視頻只需創建一次，之後想渲染多少次都可以。

創建視頻

視頻承載著時間軸：圖層、音頻、字幕、畫幅。一次調用即可創建，也可以直接複用團隊在編輯器裡做好的那一條。

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"
  }'

把渲染排進隊列

讓 renders.create 指向視頻 id，覆蓋這次任務需要改的設置，它立刻發往工作節點。返回的是任務，不是文件。

# 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"
    }
  }'

取走 mp4

render.completed 會帶著輸出地址送達。如果你的技術棧更喜歡輪詢，就按視頻 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.