Upload file | LTX Documentation

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.

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 in the upload request to cloud storage. These headers enforce upload constraints like file size limits.

1	# Get signed URL
2	curl -X POST https://api.ltx.video/v1/upload \
3	-H "Authorization: Bearer YOUR_API_KEY"
4
5	# Upload file
6	# Add each header from required_headers using -H "key: value"
7	curl -X PUT "<upload_url_from_response>" \
8	--upload-file my-video.mp4 \
9	-H "Content-Type: video/mp4"

1	{
2	"upload_url": "https://...",
3	"storage_uri": "ltx://...",
4	"expires_at": "2024-01-15T12:00:00Z",
5	"required_headers": {}
6	}

Authentication

Response

Errors