메인 콘텐츠로 건너뛰기
GET
Retrieve a Video

인증

Authorization
string
header
필수

Gateway-issued API key, formatted as sk-gateway-xxxxxxxx. Used by OpenAI-shaped endpoints (/v1/chat/completions, etc.).

경로 매개변수

video_id
string
필수

The identifier of the video to retrieve.

예시:

"video_123"

응답

Success

Structured information describing a generated video job.

id
string
필수

Unique identifier for the video job.

object
enum<string>
기본값:video
필수

The object type, which is always video.

사용 가능한 옵션:
video
model
필수

The video generation model that produced the job.

status
enum<string>
필수

Current lifecycle status of the video job.

사용 가능한 옵션:
queued,
in_progress,
completed,
failed
progress
integer
필수

Approximate completion percentage for the generation task.

created_at
integer<unixtime>
필수

Unix timestamp (seconds) for when the job was created.

completed_at
integer<unixtime> | null
필수

Unix timestamp (seconds) for when the job completed, if finished.

expires_at
integer<unixtime> | null
필수

Unix timestamp (seconds) for when the downloadable assets expire, if set.

prompt
string | null
필수

The prompt that was used to generate the video.

size
enum<string>
필수

The resolution of the generated video.

사용 가능한 옵션:
720x1280,
1280x720,
1024x1792,
1792x1024
seconds
string
필수

Duration of the generated clip in seconds. For extensions, this is the stitched total duration.

remixed_from_video_id
string | null
필수

Identifier of the source video if this video is a remix.

error
Error · object | null
필수

Error payload that explains why generation failed, if applicable.