비디오 조회

생성 API가 반환한 Video ID로 작업 상태, 생성 진행률 및 결과 메타데이터를 가져옵니다. 작업이 성공하거나 실패하면 폴링을 중지해야 합니다.

GET/v1/videos/{video_id}

생성 API가 반환한 Video ID로 비디오 작업 상태와 결과 메타데이터를 조회합니다. 비디오 생성은 비동기 과정입니다. 작업이 아직 processing 상태이면 나중에 다시 조회하고 succeeded 또는 failed 상태가 되면 폴링을 중지하세요.

폴링 횟수를 제한하고 전체 시간 제한을 설정하여 무한 또는 지나치게 빈번한 요청을 방지해야 합니다. 이 페이지는 플랫폼 Video Generations의 작업 경로와 상태 열거형을 사용하지 않습니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

video_id*string

비디오 생성 API가 반환하는 Video ID입니다.

길이1 <= length

curl -X GET "https://example.com/v1/videos/video_123"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 35
}