어떤 영상에도 자막을
API 호출 세 번으로

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`를 보내면 재시도해도 두 번째 프로젝트가 생기지 않고 첫 응답이 돌아옵니다.

   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가지 스타일 중 하나가 적용됩니다. 응답에는 단어 수, 정확한 길이, 감지된 언어가 담깁니다.

   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`를 돌려줍니다. 렌더 한 번은 길이와 무관하게 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.