동영상 조회

생성 API가 반환한 공개 작업 ID로 조회하며 단일 video 객체를 반환합니다.

GET/v1/videos/{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/v1/videos/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "id": "task_example",
  "object": "video",
  "model": "wan3.0-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1792760030,
  "completed_at": 1792760030,
  "metadata": {
    "url": ""
  }
}

상태와 동영상 URL 읽기

`status`	의미와 처리
`queued`	대기 중, 나중에 다시 조회
`in_progress`	처리 중, 나중에 다시 조회
`completed`	생성 완료, `metadata.url` 읽기
`failed`	생성 실패, 가능한 `error`를 읽고 폴링 중지
`unknown`	미인식 상태, 성공으로 처리하지 않음

응답의 id를 저장하세요. 조회는 생성 응답의 중복 필드 task_id에 의존하지 않습니다. progress, completed_at, error 유무만으로 성공을 판단하지 마세요. completed_at은 기록 업데이트 시각이며 상태는 status로 확인합니다.

성공 후 URL을 저장하거나 동영상 다운로드 API를 사용하세요. 이 API는 네이티브 output/usage를 반환하지 않습니다. 사용량은 네이티브 조회를 참고하세요.

폴링과 오류 처리

약 15초마다 조회하고 전체 시간 제한을 설정하세요. 저장된 작업 기록을 읽으므로 빠른 재조회에서는 같은 상태가 반환될 수 있습니다. 폴링 중지는 생성을 취소하지 않습니다.

HTTP 400과 task_not_exist이면 작업 ID의 사이트와 작업 소유 계정의 API Key를 확인하세요. HTTP 401이면 인증을 수정한 후 다시 조회하세요. 생성 성공은 status로 판단합니다.

Alibaba Cloud Wan 3.0 동영상 생성 공식 API 문서모델 네이티브 규격을 참고할 수 있습니다. 플랫폼 필드와 응답은 본 페이지를 따릅니다.

인증

경로 매개변수

응답 본문

200application/json

400application/json

401application/json

상태와 동영상 URL 읽기

폴링과 오류 처리

`application/json`

`application/json`

`application/json`