동영상 조회

생성 응답의 작업 ID를 저장하고 같은 사이트의 API Key로 조회합니다. 폴링을 중단해도 생성은 취소되지 않습니다.

GET/v1/video/generations/{task_id}

플랫폼 생성 응답의 ID로 현재 사용자 작업을 조회합니다. 클라이언트 폴링 중단은 생성 취소가 아닙니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

경로 매개변수

task_id*string

생성 API가 반환한 시스템 작업 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": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "processing",
    "task_id": "123456789012345678",
    "url": ""
  }
}

조회 결과 읽기

플랫폼 조회는 code/message/data 구조이며 data는 단일 작업 객체입니다. code: "success"는 조회 성공을 뜻합니다. 생성 완료 여부는 data.status로 확인하세요.

상황	의미 및 조치
HTTP 200, `data.status: "processing"`	처리 중. `data.url`는 빈 문자열일 수 있음. 나중에 다시 조회
HTTP 200, `data.status: "succeeded"`	생성 성공. `data.url`에서 URL을 읽고 즉시 저장
HTTP 400, `code: "task_not_exist"`	작업 없음. 작업 ID·API Key·사이트 확인
HTTP 401, `Invalid token`	Bearer 형식과 Key의 사이트 확인. Key 누락과 무효는 같은 오류일 수 있음

data.error와 data.metadata는 null일 수 있습니다. 플랫폼 구조는 네이티브 조회의 data[]와 다릅니다. 필드와 정가 정보는 네이티브 조회 API를 참고하세요.

HTTP 400/401은 조회 요청 오류이지 생성 실패가 아닙니다. 정상 작업 객체가 없을 수 있으므로 URL을 읽거나 폴링을 계속하기 전에 오류를 해결하세요.

인증

경로 매개변수

응답 본문

200application/json

400application/json

401application/json

조회 결과 읽기

`application/json`

`application/json`

`application/json`