Zum Hauptinhalt springen
GET
Retrieve a Video

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

video_id
string
erforderlich

The identifier of the video to retrieve.

Beispiel:

"video_123"

Antwort

Success

Structured information describing a generated video job.

id
string
erforderlich

Unique identifier for the video job.

object
enum<string>
Standard:video
erforderlich

The object type, which is always video.

Verfügbare Optionen:
video
model
erforderlich

The video generation model that produced the job.

status
enum<string>
erforderlich

Current lifecycle status of the video job.

Verfügbare Optionen:
queued,
in_progress,
completed,
failed
progress
integer
erforderlich

Approximate completion percentage for the generation task.

created_at
integer<unixtime>
erforderlich

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

completed_at
integer<unixtime> | null
erforderlich

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

expires_at
integer<unixtime> | null
erforderlich

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

prompt
string | null
erforderlich

The prompt that was used to generate the video.

size
enum<string>
erforderlich

The resolution of the generated video.

Verfügbare Optionen:
720x1280,
1280x720,
1024x1792,
1792x1024
seconds
string
erforderlich

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

remixed_from_video_id
string | null
erforderlich

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

error
Error · object | null
erforderlich

Error payload that explains why generation failed, if applicable.