Skip to navigation
API ReferenceUpload

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. The URL creates a new object and cannot overwrite an existing object. Include every header returned in required_headers in the upload request. Use the returned storage_uri in subsequent video generation requests (e.g., image_uri or video_uri parameters). The URL expires after 1 hour.

Authentication

AuthorizationBearer
API key authentication

Response

Upload URL generated successfully
upload_urlstring

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

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_atdatetime

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

required_headersmap from strings to strings
Headers that must be included unchanged in the upload request to cloud storage. These headers enforce the file size limit and prevent overwriting an existing object.

Errors

401
Unauthorized Error
500
Internal Server Error
503
Service Unavailable Error