Seedance 작업 현황 및 결과

Seedance 비디오 생성은 비동기식입니다. 생성 요청은 작업 ID를 반환합니다. 작업이 완료되거나 실패할 때까지 Modelflare를 폴링합니다.

지원 모델

작업 생성

전체 요청 본문에 대해 일치하는 모델 페이지를 사용하세요.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A cat walks through a sunlit room"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

응답에서 id을 저장합니다. 호환성 응답에서는 task_id을 사용할 수 있습니다.

작업 폴링

bash

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

대중의 반응은 비디오 제공자 전반에 걸쳐 정규화됩니다.

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

status이 queued 또는 in_progress인 동안 폴링합니다. completed 또는 failed에서 중지합니다.

상태	의미	다음 단계
queued	실행 대기 중	다시 설문조사
in_progress	처리 중	다시 설문조사
completed	동영상이 준비되었습니다	콘텐츠 다운로드
failed	작업 실패	오류를 읽고 요청을 수정하세요.

서비스 응답에 이를 포함하는 경우 metadata에는 정규화된 동작, 해상도, 비율, 출력 형식, 오디오 플래그 및 토큰 사용이 포함될 수 있습니다. 이러한 필드를 선택 사항으로 처리하십시오. status과 콘텐츠 엔드포인트를 안정적인 계약으로 사용합니다.

결과 다운로드

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

콘텐츠 엔드포인트는 비디오 스트림을 반환합니다. 결과 URL은 만료될 수 있으므로 즉시 저장하세요.

실패한 작업

생성은 공급자 유효성 검사가 완료되기 전에 작업 ID를 반환할 수 있습니다. 따라서 이후 폴링에서는 작업을 failed으로 변경할 수 있습니다. 오류를 조사할 때 요청 ID를 유지하세요. 요청 봉투를 다른 모델 계열로 자동 변경하여 재시도하지 마세요.