# Ltx v2.3 | Text to Video

LTX 2.3 Text-to-Video generates 4K AI video clips up to 20 seconds from text prompts with synced audio, vertical framing, and selectable 24 or 48 FPS.

## API Information

- **Model Slug:** ltx-2-3-text-to-video
- **Branded URL:** https://www.eachlabs.ai/ltx/ltx-v2-3/ltx-2-3-text-to-video
- **Provider:** Lightricks
- **Category:** Text to Video
- **Output Type:** video
- **Status:** active
- **Base Cost:** $0.08–$0.32 per second, depending on resolution
- **Estimated Processing Time:** 100 seconds
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/ltx-2-3-text-to-video

## Pricing

- **Charge Type:** dynamic
- **Estimate:** $0.08–$0.32 per second, depending on resolution
- **Pricing Details:** 1080p: $0.08
- **Pricing Details:** 1440p: $0.16
- **Pricing Details:** 2160p: $0.32

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text description of the desired video. |
| duration | integer | No | 6 | 6, 8, 10 | Duration of the generated video in seconds. Default: 6. |
| resolution | string | No | 1080p | 1080p, 1440p, 2160p | Resolution of the generated video. Default: 1080p. |
| aspect_ratio | string | No | 16:9 | 16:9, 9:16 | Aspect ratio of the generated video. Default: 16:9. |
| fps | integer | No | 25 | 24, 25, 48, 50 | Frames per second of the generated video. Default: 25. |
| generate_audio | boolean | No | true | - | Whether to generate audio for the video. Default: true. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ltx-2-3-text-to-video",
  "input": {
    "prompt": "a luminous butterfly flying slowly through a misty enchanted garden at sunset, glowing particles trailing behind their wings, dreamy purple and gold lighting, cinematic motion, soft volumetric light rays, magical natural atmosphere, ultra aesthetic fantasy realism, smooth camera movement, premium AI video thumbnail style"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated video)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Ltx v2.3 | Text to Video Overview**

The **Ltx v2.3 | Text to Video** model from LTX transforms text prompts into high-quality video clips, enabling users to generate dynamic visuals from simple descriptions. Part of the ltx-v2.3 family, it leverages an OpenAPI schema optimized for queue-based processing via the LTX provider, making it ideal for scalable video creation workflows. This model stands out for its efficient handling of text-to-video generation through fal-ai/ltx-2.3/text-to-video queue, delivering consistent results for creative and professional applications. Available on **each::labs** (eachlabs.ai), it simplifies access to advanced AI video synthesis without complex setups. Whether prototyping animations or producing marketing content, Ltx v2.3 | Text to Video streamlines the process from idea to output.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.