v1

latestOpenAPI 3.1.02026-08-04143345.6 KB

upload

Upload file

Generate a signed URL for uploading media files to use as input for video generation.

Returns a pre-signed URL that can be used to upload files directly to cloud storage. Use the returned storage_uri in subsequent video generation requests (e.g., image_uri or video_uri parameters). The URL expires after 1 hour.

post/v1/upload

Headers

Authorizationstring required

API key authentication

Response

Upload URL generated successfully

upload_urlstring required

Pre-signed URL for uploading the file. Use PUT request to upload your file to this URL. The URL includes all necessary authentication and expires after 1 hour.

storage_uristring required

Storage URI that can be used to reference the uploaded file in subsequent API requests. Use this value in image_uri or video_uri parameters. The uploaded file will be available for 24 hours.

expires_atstring date-time required

ISO 8601 timestamp indicating when the signed URL expires (1 hour from creation).

required_headersobject required

Headers that must be included in the upload request to cloud storage. These headers enforce upload constraints like file size limits.