完成した動画を
コードから直接書き出す

1. 1

   動画を作成する

   動画はタイムラインそのものです。レイヤー、音声、字幕、フォーマット。1 回の呼び出しで作るか、チームがエディタで組んだものをそのまま使えます。

   curlNoderesponse

   コピー

   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

   レンダリングをキューに入れる

   renders.create に動画 ID を渡し、このジョブだけ変えたい設定を上書きすれば、すぐワーカーへ送られます。返るのはジョブであって、ファイルではありません。

   curlNoderesponse

   コピー

   # 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 を受け取る

   render.completed が出力 URL とともに届きます。ポーリングが好みなら、動画 ID で絞り込んでレンダリング一覧を読み直してください。

   webhookeventpolling

   コピー

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

開発者が最初に聞くこと