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

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

작업 ID로 상태와 결과를 조회합니다. 기본 응답은 code, message, data로 구성된 플랫폼 호환 래퍼를 사용합니다. raw=true이면 Volcengine Ark 네이티브 작업 구조를 직접 반환하고 show_raw=true이면 data.data에 같은 네이티브 구조를 포함하며 show_usage=true이면 data.usage에 플랫폼이 정리한 사용량 정보를 포함합니다. 비디오 URL에 유효 기간이 있을 수 있으므로 즉시 별도 저장하세요.

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

Draft 샘플과 최종 영상을 조회할 때 원시 데이터의 draft, draft_task_id로 작업을 구분할 수 있습니다. 전체 절차는 Draft 샘플 영상 생성 가이드를 참조하세요.

GET/v1/video/generations/{task_id}

생성 API가 반환한 작업 ID로 Seedance 2.5 비디오 작업을 조회합니다. 기본 응답은 code, message, data로 구성된 플랫폼 호환 래퍼입니다. 작업이 succeeded, completed 또는 failed 상태가 되면 폴링을 중단해야 합니다.

raw=true를 전달하면 Volcengine Ark 네이티브 작업 구조를 직접 읽을 수 있습니다. show_raw=true이면 호환 래퍼의 data.data에 같은 네이티브 구조를 포함하고, show_usage=true이면 성공한 작업의 data.usage에 플랫폼이 정리한 사용량 정보를 포함합니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

경로 매개변수

task_id*string

Seedance 2.5 작업 생성 시 반환된 작업 ID입니다.

길이1 <= length

쿼리 매개변수

raw?boolean

true를 전달하면 저장된 업스트림 원본 작업 데이터를 직접 반환합니다.

show_raw?boolean

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

show_usage?boolean

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

응답 본문

`application/json`

curl -X GET "https://example.com/v1/video/generations/task_xxxxx"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "succeeded",
    "url": "https://example.com/generated-video.mov",
    "format": "mov",
    "metadata": null,
    "error": null
  }
}

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

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

인증

경로 매개변수

쿼리 매개변수

응답 본문

200application/json

400application/json

401application/json

402application/json

404

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`