どんな動画にも字幕を
APIコール3回で

const API = 'https://autostud.ai/api/v1'
const KEY = process.env.AUTOSTUD_API_KEY

const call = async (path, body) => {
  const response = await fetch(API + path, {
    method: body ? 'POST' : 'GET',
    headers: {
      Authorization: `Bearer ${KEY}`,
      'Content-Type': 'application/json',
    },
    body: body ? JSON.stringify(body) : undefined,
  })

  const payload = await response.json()
  if (!response.ok) throw new Error(payload.error?.message || response.statusText)
  return payload
}

// 1. A video project to hang the timeline on.
const created = await call('/actions/videos.create', {
  video_name: 'Interview clip',
  video_type_id: 'timeline',
  video_format: 'portrait',
  video_lang: 'en',
})
const video_id = created.data.video_id

// 2. Transcribe, emphasise, style — one call.
const subtitled = await call('/actions/subtitles.generate', {
  video_id,
  media_url: 'https://cdn.example.com/interview.mp4',
  style_preset: 'beast',
  words_per_group: 3,
})
console.log(subtitled.data.word_count, 'words', subtitled.data.duration_seconds, 's')

// 3. Render it.
await call('/actions/renders.create', {
  video_id,
  video_type_id: 'timeline',
  video_format: 'portrait',
})

// 4. Wait for the worker. A webhook is better; this is the short version.
let render
do {
  await new Promise((resolve) => setTimeout(resolve, 15000))
  const list = await call(`/renders?video_id=${video_id}&limit=1`)
  render = list.data[0]
} while (render && ['not_started', 'processing'].includes(render.render_status))

if (render.render_status !== 'done') throw new Error('Render failed')
console.log(render.render_url)

ベースURL: https://autostud.ai/api/v1 — 認証は `Authorization: Bearer sk_live_…`。`sk_test_` キーは同じ経路をすべて通ったうえで、消費の直前で止まります。

1. 1

   APIキーを作る

   ダッシュボード → 設定 → APIキー。スコープを自分で選ばないなら「Automation」プリセットで十分です（動画・レンダー・ファイルを含みます）。シークレットの表示は一度きり。`sk_live_` は消費し、`sk_test_` はリクエスト全体を検証して書き込み前に止まります。

   curlresponse

   コピー

   export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
   
   # What can this key actually do?
   curl https://autostud.ai/api/v1 \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY"

2. 2

   動画をURLに置く

   アップロード用エンドポイントはありません。APIが読むのはURLです。自社バケット、CDN、署名付きリンク — 当社サーバーが取得できれば何でも構いません。ワークスペースのライブラリへの登録は任意です。

   curl

   コピー

   # The API takes a URL, never a file upload. Anything publicly
   # reachable works: your bucket, your CDN, a signed URL.
   export MEDIA_URL="https://cdn.example.com/interview.mp4"
   
   # Optional: keep a record of it in the workspace library.
   curl -X POST https://autostud.ai/api/v1/assets \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "provider_file_url": "'"$MEDIA_URL"'",
       "provider_file_name": "interview.mp4",
       "file_mime_type": "video/mp4",
       "provider_file_id": "interview-2026-08-18",
       "sync_method": "api"
     }'

3. 3

   動画プロジェクトを作る

   `videos.create` が返す `video_id` に、以降すべてがぶら下がります。`Idempotency-Key` を付ければ、再送しても2つ目のプロジェクトは作られず最初の応答が返ります。

   curlresponse

   コピー

   curl -X POST https://autostud.ai/api/v1/actions/videos.create \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: interview-2026-08-18" \
     -d '{
       "video_name": "Interview clip",
       "video_type_id": "timeline",
       "video_format": "portrait",
       "video_lang": "en"
     }'

4. 4

   字幕を付ける

   `subtitles.generate` がサーバー側で全部やります。Whisper が単語単位で文字起こしし、AI が強調語を印し、116種類のスタイルから1つを適用。応答には単語数・正確な尺・検出言語が入ります。

   curlresponse

   コピー

   export VIDEO_ID="9f0c4e2a-1d6b-4a77-9d51-6b0f2e8c3a4d"
   
   curl -X POST https://autostud.ai/api/v1/actions/subtitles.generate \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "video_id": "'"$VIDEO_ID"'",
       "media_url": "'"$MEDIA_URL"'",
       "style_preset": "beast",
       "words_per_group": 3,
       "enable_emphasis": true,
       "enable_diarization": false
     }'

5. 5

   レンダーを投入する

   `renders.create` がワーカー群にジョブを載せ、即座に `render_id` を返します。1レンダーは長さに関係なく20クレジットです。

   curlresponse

   コピー

   curl -X POST https://autostud.ai/api/v1/actions/renders.create \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "video_id": "'"$VIDEO_ID"'",
       "video_type_id": "timeline",
       "video_format": "portrait"
     }'

6. 6

   mp4 を受け取る

   `render.completed` を購読すれば、完成URLが署名付きで届きます。取りに行きたい場合は、その動画のレンダー一覧を取得して `render_status` が `done` になるまで読んでください。

   webhookpollingresponse

   コピー

   # Register once, then stop polling.
   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.completed", "render.failed"],
       "description": "Subtitled videos"
     }'
   # The signing secret comes back once, in this response. Store it.