APIAI 영상 생성 API

AI 영상을 생성하세요
내 백엔드에서 바로

POST 한 번이면 프롬프트나 정지 이미지가 생성 클립이 됩니다. Veo, Kling, Sora, Seedance를 엔드포인트 하나 뒤에. 과금은 생성 단위, 전달은 웹훅.

POSThttps://autostud.ai/api/v1/actions/videos_ai.generate

처음부터 끝까지 세 번

엔진은 한 번만 고르고, 이후에는 원하는 만큼 생성하세요.

영상 에이전트 고르기

에이전트는 저장된 모델 설정입니다: 엔진, 해상도, 비율, 기본값. 워크스페이스의 목록을 불러와 id를 보관하세요.

export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# A video agent is a saved model configuration, not a model name.
curl "https://autostud.ai/api/v1/agents?agent_type=video&limit=10" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

프롬프트 보내기

텍스트만 보내도 되고, 움직이게 할 정지 이미지를 함께 보내도 됩니다. 응답에는 생성 id와 사용한 크레딧이 담깁니다.

curl -X POST https://autostud.ai/api/v1/actions/videos_ai.generate \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lighthouse-shot-01" \
  -d '{
    "agent_id": "b21f7d90-3c44-4e1a-9f77-0c2ad5e6b118",
    "prompt": "A lighthouse at dusk, slow push-in, waves breaking under it",
    "duration": 8
  }'

클립 받기

generation.completed 웹훅을 받거나, 폴링이 편하면 생성을 다시 읽으세요. 호스팅된 URL이 레코드에 있습니다.

# Register once. Every generation 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": ["generation.completed", "generation.failed"],
    "description": "AI video"
  }'
# The signing secret comes back once, in this response. Store it.

보낼 수 있는 값

필드는 네 개. 나머지는 에이전트에 있으니 호출은 짧게 유지됩니다.

agent_id

실행할 영상 에이전트. 엔진과 기본값이 결과물의 모습을 결정합니다.

prompt

장면에서 무슨 일이 일어나야 하는지. 엔진은 감독의 지시처럼 읽습니다.

image_url

선택. 텍스트만으로 생성하는 대신 움직이게 할 정지 이미지.

duration

만들 영상 길이(초). 엔진이 지원하는 범위 안에서 지정합니다.

엔드포인트 뒤의 엔진

엔진은 각각 에이전트로 노출됩니다. 모델을 바꾸는 것은 id를 바꾸는 일이지 연동을 바꾸는 일이 아닙니다. 새 엔진은 새 에이전트로 추가됩니다.

VeoKlingSoraSeedanceRunway

폴링은 그만

웹훅 하나만 등록하면 모든 생성이 스스로 알립니다. 페이로드는 서명되고 재시도되며, 실패했을 때도 사용한 크레딧을 알려줍니다.

generation.completedgeneration.failed

개발자가 가장 먼저 묻는 것

생성에 얼마나 걸리나요?

엔진과 길이에 따라 다릅니다. 몇 초짜리 영상에 몇 분의 연산이 듭니다. 호출은 즉시 id를 돌려주므로 앱에서 기다릴 필요가 없습니다.

비용은 얼마인가요?

생성은 크레딧으로 과금되며 단가는 엔진마다 다릅니다. 모든 응답이 사용한 크레딧을 알려주고, 전체 내역은 /api/v1/generations에서 볼 수 있습니다.

가지고 있는 이미지를 움직일 수 있나요?

네. 공개적으로 접근 가능한 이미지를 image_url로 보내면 프롬프트만으로 생성하는 대신 그 이미지를 움직입니다.

나중에 클립을 늘릴 수 있나요?

생성 id와 다음 구간 프롬프트로 videos_ai.extend를 호출하세요. 연장도 하나의 생성이라 같은 방식으로 과금됩니다.

OpenAPI 명세 에러 코드 API 살펴보기

이제 만들어 볼까요?

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

무료로 시작하기

또는데모 보기

안전한 결제

즉시 이용

언제든 해지

AI 영상을 생성하세요내 백엔드에서 바로