메인 콘텐츠로 건너뛰기
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
ByteDance Jimeng 작업을 생성한 후 이 엔드포인트를 사용하세요. 이 엔드포인트는 렌더링을 시작하지 않습니다. 현재 작업 상태만 보고하며, 작업이 완료되면 생성된 비디오 URL과 출력 메타데이터를 반환합니다.

다음 필드를 확인하세요

  • 현재 provider 상태를 나타내는 status
  • 렌더링이 완료되었을 때의 content.video_url
  • 애플리케이션에서 출력 메타데이터가 필요한 경우 resolution, duration, ratio, framespersecond

폴링 루프

1

먼저 작업 생성

ByteDance 비디오 생성부터 시작하세요.
2

task id로 폴링

status가 최종 상태에 도달할 때까지 이 엔드포인트를 계속 호출하세요.
3

결과 저장

content.video_url이 나타나면 장기 보관이 필요할 경우 결과를 자체 스토리지에 복사하세요.

결과 URL

ByteDance 워크플로는 여전히 먼저 생성한 다음 task id로 조회하는 방식입니다. CometAPI는 이 구조를 유지하면서 인증을 표준화합니다. 반환된 비디오 URL은 영구 저장소가 아닌 전달용 URL로 취급하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

id
string
필수

Task id returned by the create endpoint.

응답

200 - application/json

Current task state.

id
string
필수
model
string
필수
status
string
필수

Provider task status.

created_at
integer
필수
updated_at
integer
필수
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer