AGTCloud API Docs
가이드API 레퍼런스통합 및 리소스업데이트 및 도움말
비디오 생성PixVerse

PixVerse 동영상 조회

생성 시 반환된 네이티브 작업 ID로 상태와 동영상 결과를 조회합니다.

GET/openapi/v2/video/result/{task_id}

인증

bearerAuth
인증Bearer <token>

플랫폼 API Key를 Authorization: Bearer your-api-key 형식으로 사용합니다.

전달 위치: header

경로 매개변수

task_id*string

생성 시 반환된 Resp.video_id입니다. 모든 자릿수를 유지하고 접두사를 추가하지 마세요.

패턴^[0-9]+$

Header 매개변수

Ai-trace-id?string

선택적 고유 추적 값입니다. 생략하면 플랫폼에서 생성하며 멱등성 키가 아닙니다.

응답 본문

application/json

application/json

application/json

application/json

작업 상태 확인

HTTP 200은 조회 응답을 받았다는 뜻입니다. 먼저 ErrCode, 다음으로 Resp.status를 확인하세요. 5는 처리 중이며 3~5초 간격으로 조회할 수 있습니다. 1은 성공으로 Resp.url에서 동영상 URL을 읽습니다. 7은 심사 실패, 8은 생성 실패이므로 조회를 중단하세요.

네이티브 작업 ID의 모든 자릿수를 보관하세요. 생성이 오래 걸린다는 이유로 즉시 다시 생성하지 마세요. 성공 후 동영상을 신속히 다운로드하거나 옮기세요.

PixVerse 동영상 조회 — 공식 문서해당 공급자 프로토콜 정의를 확인하세요.