Input Formats

Media input specification for the API

Input Methods

The API accepts media through image_uri, video_uri, and audio_uri parameters using three methods:

MethodMax Size
Cloud Storage200 MB
HTTPS URL15 MB (images), 32 MB (videos/audio)
Data URI7 MB (images), 15 MB (videos/audio)

Cloud Storage Upload

Upload via v1/upload endpoint. Returns a storage_uri for use in generation requests.

1{
2 "image_uri": "ltx://uploads/abc-123"
3}
Max file sizeUpload URL expiresFile availableAuthentication
200 MB1 hour24 hoursAPI key
200 MB is the upload endpoint cap. Each feature applies its own size limit when the file is used in a generation request (for example, images are capped at 15 MB), so a large upload may be rejected at generation time depending on the endpoint.

HTTPS URL

Direct link to publicly accessible files. API fetches during request.

1{
2 "image_uri": "https://example.com/sunset.jpg"
3}
PropertyImagesVideosAudio
Max size15 MB32 MB32 MB
Timeout10s30s30s

Requirements:

  • HTTPS only
  • Domain names (no IPs)
  • Publicly accessible
  • No redirects

Data URI (Base64)

Inline base64-encoded data. Format: data:{mime-type};base64,{encoded-data}

1{
2 "image_uri": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA..."
3}
PropertyImagesVideosAudio
Max encoded size7 MB15 MB15 MB
Base64 encoding increases file size by ~33%.

Supported Formats

Images

FormatMIME Type
PNGimage/png
JPEG / JPGimage/jpeg
WEBPimage/webp

Videos

FormatMIME TypeCodecs
MP4video/mp4H.264, H.265
MOVvideo/quicktimeH.264, H.265
MKVvideo/x-matroskaH.264, H.265

Audio

FormatMIME TypeCodecs
WAVaudio/wavAAC-LC, MP3, Vorbis, FLAC
MP3audio/mpegMP3
M4Aaudio/mp4AAC-LC
OGGaudio/oggOpus, Vorbis
AAC audio must use AAC-LC profile (1024 samples/frame). HE-AAC and HE-AACv2 (2048 samples/frame) are not supported. PCM audio is not supported.