동영상 조회

Wan 3.0 네이티브 작업 상태, 동영상 주소 및 사용량을 읽습니다.

생성 응답의 output.task_id로 조회하며 반환된 output.task_id도 플랫폼 공개 ID입니다. 결과와 사용량은 output과 usage에 있습니다.

GET/api/v1/tasks/{task_id}

인증

bearerAuth

인증Bearer <token>

플랫폼 API Key 사용: Authorization: Bearer your-api-key.

전달 위치: header

경로 매개변수

task_id*string

플랫폼이 반환한 공개 작업 ID입니다. 문자열로 저장하고 조회·다운로드에 사용하세요. request_id나 중첩된 업스트림 작업 ID를 사용하지 마세요.

길이1 <= length

응답 본문

`application/json`

curl -X GET "https://api.agtcloud.cn/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "output": {
    "task_id": "task_example",
    "task_status": "PENDING"
  },
  "request_id": "REQUEST_ID"
}

상태와 결과

`output.task_status`	의미와 처리
`PENDING`	대기 중
`RUNNING`	처리 중
`SUCCEEDED`	성공, `output.video_url` 읽기
`FAILED`	실패, `output.code/message` 확인 후 폴링 중지
`CANCELED`	취소됨, 폴링 중지
`UNKNOWN`	알 수 없는 상태, 성공으로 처리하지 않음

약 15초마다 조회하고 전체 시간 제한을 설정하세요. 플랫폼에 저장된 기록은 백그라운드에서 업데이트됩니다. 재생성 대신 조회를 사용하세요.

생성 성공 후 결과 URL이 만료되기 전에 동영상을 다운로드해 저장하세요.

사용량과 시간 필드

usage.duration은 총 사용 시간이며 입력 동영상이 있으면 입력·출력을 합산합니다. input_video_duration/output_video_duration은 소수일 수 있으므로 요청 길이의 정수 규칙을 적용하지 마세요. video_count, fps, SR, ratio도 반환될 수 있습니다.

submit_time/scheduled_time/end_time은 존재할 때 반환되는 UTC+8 문자열이며 Unix 타임스탬프가 아닙니다. request_id는 요청 추적용이며 작업 조회에 사용하지 않습니다.

조회 오류

HTTP 400과 task_not_exist이면 공개 작업 ID, 사이트, API Key 계정을 확인하세요. 이는 작업의 UNKNOWN 상태와 다릅니다. HTTP 401이면 Bearer 인증을 확인하세요.

오류는 output 없이 최상위 code/message/request_id만 포함할 수 있습니다. video 객체 형식은 플랫폼 조회를 참고하세요.

Alibaba Cloud Wan 3.0 동영상 생성 공식 API 문서모델 네이티브 매개변수, 소재 규격과 조합 규칙을 확인하세요.

인증

경로 매개변수

응답 본문

200application/json

400application/json

401application/json

상태와 결과

사용량과 시간 필드

조회 오류

`application/json`

`application/json`

`application/json`