API영상 렌더링 API

완성된 영상을
코드에서 바로 뽑아내세요

POST 한 번이면 렌더링이 워커 큐에 들어가고, 서명된 웹훅이 mp4를 건네줍니다. ffmpeg 설치도, GPU 임대도, 큐 감시도 필요 없습니다.

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

세 번의 호출, 타임라인에서 mp4까지

영상은 한 번만 만들고, 필요한 만큼 렌더링하세요.

  1. 1

    영상을 만든다

    영상은 타임라인 자체입니다. 레이어, 오디오, 자막, 포맷. 한 번의 호출로 만들거나 팀이 에디터에서 만든 것을 그대로 쓰면 됩니다.

    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로 겨냥하고 이 작업에만 필요한 설정을 덮어쓰면 바로 워커로 갑니다. 응답은 작업이지 파일이 아닙니다.

    # 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로 필터링해 렌더링 목록을 다시 읽으세요.

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

렌더링이 받는 것

시작에 두 개의 필드, 안전한 재시도에 헤더 하나, 추적에 id 하나.

video_id

렌더링할 영상. 구성에 관한 모든 것이 이미 그 안에 있습니다.

render_settings

이 작업에만 적용할 선택적 재정의: 포맷, 품질, 원하는 프레임 범위.

Idempotency-Key

헤더입니다. 같은 키를 두 번 보내면 첫 번째 렌더링이 돌아오고, 중복은 생기지 않습니다.

render_id

호출이 돌려주고 모든 웹훅이 실어 나르므로, 완성된 mp4는 언제나 그것을 요청한 작업을 가리킵니다.

무엇이 나오나

렌더링 결과는 영상에 설정된 포맷의 H.264 mp4입니다. 틱톡과 릴스에는 세로, 피드에는 정사각, 유튜브에는 가로. 같은 타임라인, 다른 출력입니다.

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

폴링은 그만

렌더링은 밀리초가 아니라 분 단위입니다. 웹훅 하나만 등록하면 세 개의 이벤트가 워커가 작업을 집어든 시점, 파일이 준비된 시점, 무언가 실패한 시점을 알려줍니다.

render.startedrender.completedrender.failed

개발자가 가장 먼저 묻는 것

렌더링은 얼마나 걸리나요?

영상 길이와 레이어 수에 비례해 몇 분입니다. 호출은 작업이 큐에 들어가자마자 응답하므로 앱에서 기다릴 일이 없습니다.

렌더링 비용은 얼마인가요?

렌더링은 크레딧으로 과금되고 원장은 API로 읽을 수 있습니다. 키를 renders:read로만 제한하면 대시보드가 작업을 시작하지 못한 채 지출만 지켜볼 수 있습니다.

실패한 호출을 안전하게 재시도할 수 있나요?

네. Idempotency-Key 헤더를 보내면 반복된 호출이 두 번째를 큐에 넣는 대신 원래 렌더링을 돌려줍니다. API의 모든 실행 액션이 같은 보장을 제공합니다.

파일은 어디에 저장되나요?

저희 CDN에 있으며 URL은 렌더링 레코드와 render.completed 페이로드 양쪽에 들어 있습니다. 영구 보관이 필요하면 내려받아 직접 저장하세요.

이제 만들어 볼까요?

바이럴 영상을 몇 분 만에. 무료 체험에는 카드 등록이 필요 없습니다.

안전한 결제
즉시 이용
언제든 해지