LTX Video 2.3 Quality Outpaint

VIDEOFeaturedlightricks-ltx-v2-3-quality-outpaint

LTX Video 2.3 Quality Outpaint is a spatial video outpainting model from Lightricks that extends a source clip onto a larger canvas. It supports 480p, 720p, and 1080p output at 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, or 9:21, with optional native audio and clips up to 20 seconds. Built for reframing existing footage into new aspect ratios without a hard crop.

POST

/v2/workspaces/{workspace_id}/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences

curl --request POST \
  --url https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "a knight standing in a snowy forest",
  "aspect_ratio": "LANDSCAPE_16_9_1080p",
  "quality": "XHIGH",
  "duration_seconds": 5,
  "fps": "24",
  "generate_audio": false,
  "guidance_file_init_video": [
    {
      "url": "<file_url>"
    }
  ]
}'

import requests

url = "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences"

payload = {
    "prompt": "a knight standing in a snowy forest",
    "aspect_ratio": "LANDSCAPE_16_9_1080p",
    "quality": "XHIGH",
    "duration_seconds": 5,
    "fps": "24",
    "generate_audio": False,
    "guidance_file_init_video": [{ "url": "<file_url>" }]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = 'https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"prompt":"a knight standing in a snowy forest","aspect_ratio":"LANDSCAPE_16_9_1080p","quality":"XHIGH","duration_seconds":5,"fps":"24","generate_audio":false,"guidance_file_init_video":[{"url":"<file_url>"}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences"

  payload := strings.NewReader("{\n  \"prompt\": \"a knight standing in a snowy forest\",\n  \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n  \"quality\": \"XHIGH\",\n  \"duration_seconds\": 5,\n  \"fps\": \"24\",\n  \"generate_audio\": false,\n  \"guidance_file_init_video\": [\n    {\n      \"url\": \"<file_url>\"\n    }\n  ]\n}")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'a knight standing in a snowy forest',
    'aspect_ratio' => 'LANDSCAPE_16_9_1080p',
    'quality' => 'XHIGH',
    'duration_seconds' => 5,
    'fps' => '24',
    'generate_audio' => null,
    'guidance_file_init_video' => [
        [
                'url' => '<file_url>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"prompt\": \"a knight standing in a snowy forest\",\n  \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n  \"quality\": \"XHIGH\",\n  \"duration_seconds\": 5,\n  \"fps\": \"24\",\n  \"generate_audio\": false,\n  \"guidance_file_init_video\": [\n    {\n      \"url\": \"<file_url>\"\n    }\n  ]\n}");
Request request = new Request.Builder()
  .url("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

require 'uri'
require 'net/http'

url = URI("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"a knight standing in a snowy forest\",\n  \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n  \"quality\": \"XHIGH\",\n  \"duration_seconds\": 5,\n  \"fps\": \"24\",\n  \"generate_audio\": false,\n  \"guidance_file_init_video\": [\n    {\n      \"url\": \"<file_url>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

var client = new RestClient("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/lightricks-ltx-v2-3-quality-outpaint/inferences");
var request = new RestRequest("", Method.Post);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"prompt\": \"a knight standing in a snowy forest\",\n  \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n  \"quality\": \"XHIGH\",\n  \"duration_seconds\": 5,\n  \"fps\": \"24\",\n  \"generate_audio\": false,\n  \"guidance_file_init_video\": [\n    {\n      \"url\": \"<file_url>\"\n    }\n  ]\n}", ParameterType.RequestBody);
var response = client.Execute(request);

Authorizations

bearerAuth
oauth2

Parameters

Path Parameters

workspace_id

required

Workspace Id

Id of the workspace that owns the resource.

string format: uuid

Id of the workspace that owns the resource.

Query Parameters

session_name

Session Name

Organize this run under a named session. A new session is created if none matches.

string

nullable

Organize this run under a named session. A new session is created if none matches.

Header Parameters

Idempotency-Key

string

<= 255 characters

Opaque key making this request safe to retry. The first request with a given key executes; a later request with the same key returns that first response with Idempotent-Replayed: true instead of executing again. The key covers the method, path, query, and body it was first used with; reusing it for a different request is rejected with 422. Replayable for 24 hours.

Request Body^required

application/json

LTX Video 2.3 Quality Outpaint

object

prompt

Prompt

string

negative_prompt

Negative Prompt

Advanced field.

string

aspect_ratio

Aspect Ratio

string

default: LANDSCAPE_16_9_1080p

Allowed values: LANDSCAPE_21_9_1080p PORTRAIT_9_21_1080p LANDSCAPE_16_9_1080p PORTRAIT_9_16_1080p LANDSCAPE_4_3_1080p PORTRAIT_3_4_1080p SQUARE_1080p LANDSCAPE_21_9_720p PORTRAIT_9_21_720p LANDSCAPE_16_9_720p PORTRAIT_9_16_720p LANDSCAPE_4_3_720p PORTRAIT_3_4_720p SQUARE_720p LANDSCAPE_21_9_480p PORTRAIT_9_21_480p LANDSCAPE_16_9_480p PORTRAIT_9_16_480p LANDSCAPE_4_3_480p PORTRAIT_3_4_480p SQUARE_480p

quality

Quality

string

default: XHIGH

Allowed values: LOW MEDIUM HIGH XHIGH

seed

Seed

Advanced field.

integer

nullable

guidance_scale

Guidance Scale

Advanced field.

number

default: 1 >= 1 <= 20 multiple of 0.5

inference_steps

Inference Steps

Advanced field.

integer

default: 15 >= 8 <= 30 multiple of 1

duration_seconds

Duration

integer

default: 5

fps

FPS

string

default: 24

Allowed value: 24

generate_audio

Generate Audio

boolean

guidance_file_init_video

required

Source video

The video to modify

Array<object>

>= 1 items

InferenceFormFileRef

A single guidance/reference file supplied to a reference_image_list field.

The slot’s guidance type is fixed by the field it’s attached to; the caller supplies the file URL and, where the model supports per-file weighting, a weight.

object

url

required

Url

string

weight

Weight

number

nullable

prompt_language

Prompt Language

Advanced field.

string

nullable

Example

{
  "prompt": "a knight standing in a snowy forest",
  "aspect_ratio": "LANDSCAPE_16_9_1080p",
  "quality": "XHIGH",
  "duration_seconds": 5,
  "fps": "24",
  "generate_audio": false,
  "guidance_file_init_video": [
    {
      "url": "<file_url>"
    }
  ]
}

Responses

202

Successful Response

application/json

ExecuteForgeOutput

object

inference_id

required

Inference Id

Unique identifier for this forge run.

string format: uuid

status

required

InferenceStatus

Current status: IN_PROGRESS.

string

Allowed values: in_progress complete failed cancelled deleted

estimated_price_creative_units

Estimated Price Creative Units

Estimated price in Creative Units.

number

nullable

poll_interval_seconds

required

Poll Interval Seconds

Suggested polling interval in seconds.

integer

created_at

required

Created At

Timestamp of when the run was created.

string format: date-time

session_id

Session Id

Session ID the run was added to, if a session was specified.

string format: uuid

nullable

normalized_parameters

Any of:

NormalizedInferenceParameters
null

NormalizedInferenceParameters

Inference parameters after model-specific normalization.

These reflect the actual values used for generation, including model defaults applied for any parameters not explicitly set.

object

width

Width

Resolved output width in pixels.

integer

nullable

height

Height

Resolved output height in pixels.

integer

nullable

batch_size

Batch Size

Number of outputs to generate.

integer

nullable

num_inference_steps

Num Inference Steps

Resolved number of diffusion steps.

integer

nullable

guidance_scale

Guidance Scale

Resolved guidance scale.

number

nullable

duration_seconds

Duration Seconds

Resolved output length in seconds — video duration or audio clip length.

number

nullable

fps

Fps

Resolved FPS.

integer

nullable

Example

{
  "status": "in_progress"
}

401

Unauthenticated — missing or invalid Bearer token.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

403

Forbidden — insufficient permissions, or the access token lacks the scope the operation requires.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

404

Resource not found.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

409

The request with this Idempotency-Key is still running — retry after the number of seconds in Retry-After.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

422

Invalid input parameters, or an Idempotency-Key reused for a different request.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

429

Rate limited — retry after the number of seconds in Retry-After.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

500

Internal server error.

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

required

string

Example

{
  "type": "https://api.layer.ai/errors/ERROR_CODE",
  "title": "Error Title",
  "status": 400,
  "detail": "Human-readable description."
}

LTX Video 2.3 Quality Outpaint

Authorizations

Parameters

Path Parameters

Query Parameters

Header Parameters

Request Bodyrequired

Example

Responses

202

Example

401

Example

403

Example

404

Example

409

Example

422

Example

429

Example

500

Example

Request Body^required