작업 조회 · 기존 형식

이 경로는 code/message/data 구조의 기존 작업 객체를 반환합니다. 신규 연동은 플랫폼 조회 API를 권장하며 응답 구조를 바꿔 사용할 수 없습니다.

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

{
  "code": "success",
  "message": "",
  "data": {
    "created_at": 1792760030,
    "updated_at": 1792760030,
    "task_id": "task_example",
    "status": "NOT_START",
    "fail_reason": "",
    "submit_time": 1792760030,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "request_id": "REQUEST_ID",
      "output": {
        "task_id": "upstream_task_example",
        "task_status": "PENDING"
      }
    }
  }
}

기존 결과 읽기

code: "success"는 조회 성공만 뜻합니다. data.status도 확인하세요:

상태	의미
`NOT_START/SUBMITTED/QUEUED`	시작 전, 제출됨 또는 대기 중
`IN_PROGRESS`	처리 중
`SUCCESS`	성공, `data.result_url` 읽기
`FAILURE`	실패, `data.fail_reason` 확인 후 폴링 중지

data.progress는 "100%" 같은 문자열이며 플랫폼 조회의 숫자 진행률과 다릅니다. created_at/updated_at/submit_time/start_time/finish_time은 Unix 초 타임스탬프이며 시작·완료 전 해당 시각은 0일 수 있습니다. 예시는 작업 관련 필드만 표시하며 실제 응답에는 다른 필드가 있을 수 있습니다.

조회·다운로드에는 생성 시 반환된 공개 ID, 즉 이 응답의 data.task_id를 사용합니다. data.data는 네이티브 응답이며 내부 ID는 플랫폼 조회·다운로드에 사용하지 않습니다.

폴링과 오류 처리

약 15초마다 조회하고 전체 시간 제한을 설정한 뒤 최종 상태에서 중지하세요. 완료 후 바로 저장하세요. 폴링 중지는 생성을 취소하지 않습니다.

HTTP 400 task_not_exist와 HTTP 401은 조회 요청 오류이며 정상 작업 상태가 아닙니다. 작업 데이터 처리 전 ID, 사이트, API Key를 확인하세요.

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

작업 조회 · 기존 형식

인증

경로 매개변수

응답 본문

200application/json

400application/json

401application/json

기존 결과 읽기

폴링과 오류 처리

`application/json`

`application/json`

`application/json`