동영상 생성 조회

GET /video-generations/{job_id}의 인증, 필드, 응답, 오류, 안전한 운영을 원본에서 생성한 레퍼런스입니다.

공개 베타API v1 · 1.4.0최종 확인 2026-09-15

이 페이지의 내용

작업

GET /video-generations/{job_id}

operationId: get_video_generation_v1_video_generations__job_id__get

소유한 작업을 조회합니다. Retry-After와 총 조회 기한을 준수하세요. queued, running, cancelling은 중간, succeeded, failed, cancelled는 종료 상태입니다. 후속 단계 실패에도 유용한 출력이 남을 수 있습니다. 진행률은 남은 시간 추정이 아닙니다.

인증 및 부수 효과

서버 측 Bearer API 키를 사용하세요. 필요한 권한: animations:read

유료 생성을 시작하지 않습니다. 다른 상태 변경은 위 설명을 확인하세요.

매개변수

매개변수	위치	유형	필수	제약 / 기본값	설명
`job_id`	`path`	`string`	예	`format`: `uuid`	Owned public resource UUID; task, asset, and file IDs are not interchangeable.

응답

HTTP	본문	설명
`200`	TaskResponse	Successful public response. Example values are illustrative.
`400`	APIErrorEnvelope	Invalid input; correct the request before retrying.
`401`	APIErrorEnvelope	Missing, expired, or revoked API key.
`403`	APIErrorEnvelope	Account eligibility, account status, or key scope does not allow this operation.
`404`	APIErrorEnvelope	Resource is unavailable, not owned, or its signature is invalid/expired.
`429`	APIErrorEnvelope	Account-wide rate or queue limit; wait for Retry-After.
`500`	APIErrorEnvelope	Internal failure; preserve the task/key and retry only when marked retryable.
`503`	APIErrorEnvelope	Service/provider unavailable; retry only when error.retryable is true.

응답 헤더

HTTP	헤더	유형	설명
`200`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.
`429`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.
`503`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.

응답 예제

json

{
  "created_at": "2026-08-30T00:00:00Z",
  "credits": {
    "charged": 0,
    "held": 1,
    "quoted": 1
  },
  "error": null,
  "finished_at": null,
  "id": "00000000-0000-4000-8000-000000000002",
  "metadata": {},
  "normalized_input": {},
  "object": "video_generation",
  "outputs": [
    {
      "byte_size": 1024,
      "created_at": "2026-08-30T00:00:00Z",
      "download_expires_at": "2026-08-30T01:00:00Z",
      "download_url": "https://downloads.example.invalid/illustrative-asset",
      "format": "clip_video",
      "id": "00000000-0000-4000-8000-000000000003",
      "media": {
        "duration_seconds": 5.04,
        "fps": 25,
        "frame_count": 126,
        "height": 512,
        "width": 512
      },
      "mime_type": "video/mp4",
      "object": "asset"
    }
  ],
  "progress": 1,
  "stage": "completed",
  "started_at": null,
  "status": "succeeded"
}

이 문서가 도움이 되었나요?

문서 이용 분석 허용

검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침

도움이 필요하신가요? 지원팀 문의

문서 검색