Model API

LTX-2.3 22B

Generate video with audio from images using LTX-2.3

Model id

Use this in every request
ltx-2.3-22b/image-to-video

This model has other modes with their own ids: ltx-2.3-22b/text-to-video.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ltx-2.3-22b/image-to-video",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "image_url": "https://example.com/input.png"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "ltx-2.3-22b/image-to-video", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","image_url":"https://example.com/input.png"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for ltx-2.3-22b/image-to-video
NameTypeDescription
promptrequiredstring
The prompt used for the generation.
image_urlrequiredstring (image URL)
The URL of the image to generate the video from.
num_framesinteger
The number of frames to generate.

Default: 121

video_sizestring (enum)
The size of the generated video.

Default: square_hd

One of: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9

generate_audioboolean
Whether to generate audio for the video.

Default: true

use_multiscaleboolean
Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the generation of a video at or above your requested size. This results in better coherence and details.

Default: true

fpsnumber (enum)
The frames per second of the generated video.

Default: 24

One of: 24

num_inference_stepsinteger
The number of inference steps to use.

Default: 40

video_cfg_scalenumber
The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content.

Default: 3

video_stg_scalenumber
The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content.

Default: 0

video_rescaling_scalenumber
The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance.

Default: 0.7

video_modality_scalenumber
The modality scale for the video. Controls the ratio between video and audio modalities.

Default: 3

audio_cfg_scalenumber
The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content.

Default: 7

audio_stg_scalenumber
The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content.

Default: 0

audio_rescaling_scalenumber
The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance.

Default: 0.7

audio_modality_scalenumber
The modality scale for the audio. Controls the ratio between video and audio modalities.

Default: 3

gradient_estimation_gammanumber
The gamma of gradient estimation during denoising. Set to 0 to disable.

Default: 2

use_restart_samplingboolean
Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the generated video.

Default: false

schedulerstring (enum)
The scheduler to use.

Default: ltx2

One of: ltx2, linear_quadratic, beta

accelerationstring (enum)
The acceleration level to use.

Default: regular

One of: none, regular, high, full

camera_lorastring (enum)
The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera.

Default: none

One of: none

camera_lora_scalenumber (enum)
The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera.

Default: 1

One of: 1

negative_promptstring
The negative prompt to generate the video from.

Default: news broadcast, 3d animation, computer graphics, pc game, console game, video game, cartoon, childish, watermark, logo, text, on screen text, subtitles, titles, signature, slowmo, static

seedinteger
The seed for the random number generator.
enable_prompt_expansionboolean
Whether to enable prompt expansion.

Default: true

video_output_typestring (enum)
The output type of the generated video.

Default: X264 (.mp4)

One of: X264 (.mp4), VP9 (.webm), PRORES4444 (.mov), GIF (.gif)

video_qualitystring (enum)
The quality of the generated video.

Default: high

One of: high

video_write_modestring (enum)
The write mode of the generated video.

Default: balanced

One of: fast, balanced, small

sync_modeboolean
If `True`, the media will be returned as a data URI and the output data won't be available in the request history.

Default: false

distill_lora_first_pass_scalenumber
The scale of the distill LoRA to use for the first pass. Set to 0 to disable.

Default: 0.2

distill_lora_second_pass_scalenumber
The scale of the distill LoRA to use for the second and subsequent passes.

Default: 0.5

interpolation_directionstring (enum)
The direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the start image.

Default: forward

One of: forward, backward

image_strengthnumber
The strength of the image to use for the video generation.

Default: 1

end_image_strengthnumber
The strength of the end image to use for the video generation.

Default: 1

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt
"outputs": [
  { "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]

Pricing

  • 1 megapixel$0.01/ megapixel

The exact charge for your input comes from a quote. How charges settle