▣ ARTIFICIAL INTELLIGENCE · SMART GENERATION

Generate Text to Video With LTX 2 Video (RTX 5090)

What it does

Text to Video Generator turns a text prompt into a short LTX-2 video and gives you a task ID to track progress. Send a prompt, and optionally seed, model, length, quality, and resolution; the generation request is queued and processed on RTX 5090 hardware.

Use it when you need quick motion content from copy, storyboards, or product ideas. length supports 3s, 5s, or 10s, quality can be fast, balanced, or best, and resolution can be sd or hd. The API responds with status, message, and task_id so you can store the job and poll later.

Poll GET /tasks/:task_id until the job reaches completed or error. The status response includes type, status, task_id, elapsed_s, and, when generation finishes, an output_url for the final MP4. If something fails, check the error field on the task response.

Text to Video Generator is a good fit for ad mockups, concept previews, social clips, and internal creative iteration where a short video draft is enough.

Notes: Text-to-video with LTX-2 19B (distilled) on a dedicated NVIDIA RTX 5090. Generates a ~5-second cinematic clip in ~30-60 seconds.

▣ ENDPOINT 01 / 02

POST

Generate a short video (LTX-2, RTX 5090)

https://api.eu.apyhub.com/mastera-ai/ltx-2-video-rtx-5090/v1/video/generate

QUICKSTART

GUIDE

Quickstart

Generate a short text-to-video task from a prompt.

curl -X POST "https://api.eu.apyhub.com/mastera-ai/ltx-2-video-rtx-5090/v1/video/generate" \
  -H 'apy-token: $APY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "length": "3s",
    "model": "ltx2",
    "prompt": "A red fox running through fresh snow, slow motion, cinematic lighting",
    "quality": "fast",
    "resolution": "sd",
    "seed": 0
  }'

What you'll get back

Returns a JSON object with status, message, and task_id string fields. status indicates the job state, message contains a human-readable note, and task_id is the queued generation task identifier.

{
  "task_id": "67ddbf74b89f",
  "status": "queued",
  "message": "Video generation started. Poll GET /v1/video/tasks/{task_id}."
}

TRY ITLIVE · 10000 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Starts a text-to-video generation request using the LTX-2 model and returns a task identifier for tracking the job. The request body includes the text prompt and optional generation settings such as seed, length, quality, and resolution.

Request Body

Parameter	Type	Mandatory	Description
prompt	String	Yes	Text description of the video to generate.
seed	Integer	No	Random seed for reproducible generation. Default: `0`.
model	ENUM	No	Video model to use. Allowed value: `ltx2`. Default: `ltx2`.
length	ENUM	No	Approximate duration. Allowed values: `3s`, `5s`, `10s`. Default: `5s`.
quality	ENUM	No	Generation quality (inference steps). Allowed values: `fast`, `balanced`, `best`. Default: `fast`.
resolution	ENUM	No	Output resolution. Allowed values: `sd` (SD 480p), `hd` (HD 720p). Default: `sd`.

Response

Returns a JSON object with status, message, and task_id fields. The status is a string indicating the job state, message is a string, and task_id is the identifier for the submitted task.

Parameter	Type	Mandatory	Description
status	String	No	Job status. Example: `queued`.
message	String	No	Informational message returned by the service.
task_id	String	No	Identifier for the submitted task.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Extract the job id from task_id in the response.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

GET

Poll LTX-2 video status (RTX 5090)

https://api.eu.apyhub.com/mastera-ai/ltx-2-video-rtx-5090/v1/video/tasks/:task_id

QUICKSTART

GUIDE

Quickstart

Fetch the status of a video generation task by its task_id.

curl -X GET "https://api.eu.apyhub.com/mastera-ai/ltx-2-video-rtx-5090/v1/video/tasks/:task_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level fields: type (string), error (string), status (queued, generating, completed, or error), task_id (string), elapsed_s (number), and output_url (string, present only when status is completed).

{
  "type": "ltx2",
  "status": "completed",
  "task_id": "ltx-task-123",
  "elapsed_s": 12.4,
  "output_url": "https://cdn.example.com/video.mp4"
}

TRY ITLIVE · 1 ATOM

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Polls the status of an LTX-2 video generation task by task_id and returns the task’s current state and related fields. When the task is completed, the response can include the finished MP4 URL in output_url.

Path Parameter(s)

Attribute	Type	Mandatory	Description
task_id	String	Yes	The task identifier in the path (`:task_id`).

Response

Returns a JSON object with type, error, status, task_id, elapsed_s, and output_url fields. The status field is a string enum that indicates the task state; output_url is only present when status is completed.

Parameter	Type	Mandatory	Description
type	String	No	Task type string; the schema example is `ltx2`.
error	String	No	Error message returned by the task, when available.
status	ENUM	No	Task state. Allowed values: `queued`, `generating`, `completed`, `error`.
task_id	String	No	The task identifier.
elapsed_s	Number	No	Elapsed time in seconds.
output_url	String	No	URL to the finished MP4, returned only when `status` is `completed`.

Path parameters

Name

Type

Description

task_idREQUIRED

string

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.