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 동영상 조회 — 공식 문서해당 공급자 프로토콜 정의를 확인하세요.