Seedance 2.0 비디오 조회(플랫폼 형식)

플랫폼 Video Generations API로 Seedance 2.0 비디오 작업을 조회합니다.

작업 ID로 상태와 결과를 조회합니다. 기본적으로 플랫폼 작업 객체를 반환합니다. raw=true이면 Volcengine Ark 네이티브 작업 구조를 직접 반환하고 show_raw=true이면 플랫폼 래퍼에 같은 네이티브 구조를 포함하며 show_usage=true이면 플랫폼이 정리한 사용량 정보를 반환합니다. 비디오와 종료 프레임 주소에 유효 기간이 있을 수 있으므로 즉시 다운로드하거나 별도 저장하세요.

Volcengine Ark 작업 구조를 직접 가져오려면 네이티브 형식 조회 API를 참조하세요.

네이티브 작업 데이터는 표준 Seedance 2.0의 4k 해상도 및 작업 priority를 지원합니다. Fast는 480p/720p만 지원합니다.

GET/v1/video/generations/{task_id}

생성 API가 반환한 작업 ID로 Seedance 2.0 비디오 작업을 조회합니다. 작업이 completed 또는 failed 상태가 되면 폴링을 중단해야 합니다.

30–60초마다 조회하는 것을 권장합니다. 완료된 비디오 URL에 유효 기간이 있을 수 있으므로 즉시 다운로드하고 별도 저장하세요.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

경로 매개변수

task_id*string

비디오 작업 생성 시 반환된 작업 ID입니다.

길이1 <= length

쿼리 매개변수

raw?boolean

true를 전달하면 문제 진단에 도움이 되도록 업스트림 원본 작업 데이터를 직접 반환합니다.

show_raw?boolean

true를 전달하면 호환 래퍼 응답의 data.data 필드에 업스트림 원본 작업 데이터를 포함합니다.

show_usage?boolean

true를 전달하고 작업이 성공하면 호환 래퍼 응답의 data.usage 필드에 사용량 정보를 포함합니다.

응답 본문

`application/json`

curl -X GET "https://example.com/v1/video/generations/cgt-20260330164007-wnc8k"

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Seedance 2.0 네이티브 작업 구조 참고raw와 show_raw에서 사용하는 Volcengine Ark 작업 조회 구조를 확인합니다.

Seedance 2.0 비디오 조회(플랫폼 형식)

인증

경로 매개변수

쿼리 매개변수

응답 본문

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`