Video API: Seedance 비동기 영상 생성

Seedance 영상 생성은 비동기로 처리됩니다. 작업을 제출해 task_id를 받고, 상태가 succeeded가 될 때까지 조회합니다. 요금은 영상 길이와 해상도에 따라 달라지며, 최신 단가는 Tokuse 요금 페이지에서 확인하세요.

엔드포인트와 인증

항목	값
작업 제출	POST /v1/video/generations
상태 조회	GET /v1/video/generations/{task_id}
인증	Authorization: Bearer sk-your-tokuse-key
모델	Seedance

지원 파라미터

영상 생성 요청에서 사용할 수 있는 값의 예시입니다.

• duration: 5초
• resolution: 480p 또는 720p
• ratio: 16:9

지원 범위는 모델 버전에 따라 달라질 수 있습니다.

요청 예시: 작업 제출

curl https://tokuse.com/v1/video/generations \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance",
    "prompt": "새벽의 한강을 따라 달리는 자전거, 부드러운 카메라 무빙",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'

응답 예시: 작업 제출

{
  "task_id": "task_01j...",
  "status": "queued"
}

상태 조회

받은 task_id로 작업 상태를 확인합니다. status가 succeeded이면 생성이 끝난 것입니다.

curl https://tokuse.com/v1/video/generations/task_01j... \
  -H "Authorization: Bearer sk-your-tokuse-key"

{
  "task_id": "task_01j...",
  "status": "succeeded"
}

주의 사항과 제한

• 영상 생성은 동기 응답이 아닙니다. 제출 응답의 task_id를 저장하고 별도로 상태를 조회해야 합니다.
• task_id를 일정 간격으로 폴링해 succeeded를 확인하세요. 너무 자주 호출하면 rate limit에 걸릴 수 있습니다.
• 해상도와 길이에 따라 생성에 몇 분이 걸릴 수 있습니다. 클라이언트 타임아웃은 제출과 조회를 분리해 설계하세요.
• 작업이 실패하면 status가 실패 상태로 바뀝니다. 재시도 전에 프롬프트와 파라미터를 확인하세요.

요금

영상 생성은 길이와 해상도에 따라 단가가 달라집니다. 긴 영상이나 높은 해상도를 요청하면 비용이 늘어납니다. 실제 단가는 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인하세요.