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 Storage100 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
100 MB1 hour24 hoursAPI key

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, Opus, 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.