Seedance Video API

Seedance 영상 생성은 비동기 Video API를 사용합니다. 먼저 작업을 제출하고 반환된 작업 ID로 상태를 조회합니다. 이 API는 Chat Completions와 별도입니다.

시작하기 전에

Modelflare API Key를 만들고 Base URL로 https://modelflare.dev/v1을 사용하세요. 공개 모델 이름은 seedance-2.0과 seedance-2.5입니다.

사용 가능한 길이와 해상도 조합은 모델마다 다를 수 있습니다. 요청 전에 모델 및 가격 페이지를 확인하세요. 지원되는 경우 해상도 값은 480p, 720p, 1080p, 4k입니다.

텍스트로 영상 생성

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "비 내리는 네온 거리에서 흰 고양이가 카메라를 향해 달리는 영화 같은 추적 장면",
    "duration": 4,
    "resolution": "720p"
  }'

이미지로 영상 생성

공개적으로 접근 가능한 HTTPS 이미지 URL을 image에 추가하세요. 나머지 필드는 텍스트 생성 요청과 같습니다.

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "피사체가 천천히 카메라를 바라보고 카메라가 조금 전진한다",
    "image": "https://example.com/reference.png",
    "duration": 4,
    "resolution": "720p"
  }'

제출 응답

제출에 성공하면 공개 작업 ID가 반환됩니다. id와 task_id는 같은 작업을 나타내므로 둘 중 하나를 저장하세요.

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued"
}

작업 상태 조회

몇 초 간격으로 조회하세요. 대기 상태는 queued, pending, processing, in_progress 등이 될 수 있으며, completed 또는 failed가 되면 폴링을 중지합니다.

curl https://modelflare.dev/v1/videos/task_example_123 \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

완료 응답 예시:

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

결과 다운로드

완료 후 content 엔드포인트에서 영상을 다운로드하세요.

curl -L https://modelflare.dev/v1/videos/task_example_123/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -o seedance.mp4

주요 요청 필드

• model: 필수. seedance-2.0 또는 seedance-2.5.
• prompt: 필수. 생성할 영상 설명.
• duration: 필수. 초 단위 정수이며 현재 최소 4초입니다. 호환용 seconds도 지원합니다.
• resolution: 필수. 선택한 모델이 지원하는 출력 해상도.
• image: 선택. 공개 HTTPS 이미지 URL이며 지정하면 이미지로 영상을 생성합니다.

HTTP 400은 보통 잘못된 매개변수, 401은 잘못된 API Key, 429는 일시적 제한을 뜻합니다. 5xx 오류는 지수 백오프로 재시도할 수 있습니다.