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.

Errors

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error

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	}