LTX-2.3
ltx-23
LTX-2.3 — генерация видео от lightricks, доступная через единый Ranvik API. Поддерживаемые возможности: fast, image_to_video, text_to_video.
от 5.28 ₽ / сек
Технические характеристики
ltx-23Возможности
- Быстро
- Видео из изображения
- Видео по тексту
Цены
| Единица | Цена |
|---|---|
| за секунду · Размеры LTX 2.3: 1280 x 704 | 5.28 ₽ |
| за секунду · Размеры LTX 2.3: 704 x 1280 | 5.28 ₽ |
| за секунду · Размеры LTX 2.3: 1920 x 1024 | 10.56 ₽ |
| за секунду · Размеры LTX 2.3: 1024 x 1920 | 10.56 ₽ |
| за секунду · Размеры LTX 2.3: 1024 x 1024 | 10.56 ₽ |
| за секунду · Размеры LTX 2.3: до 2K | 21.13 ₽ |
Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.
Поддерживаемые параметры
Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.
| Параметр | Тип | Диапазон / values | Default | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
positivePromptrequired | string | min: 2 · max: 10000 | — | Текстовый промпт описывающий генерируемое видео. Допустима очень длинная инструкция (до 10k символов). примеры значенийПримеры Кинематографический кадр: человек идёт по лесу на закате, мягкий свет, drone-like camera. | ||||||||||||
widthrequired | integer | min: 128 · max: 2048 | 1920 | Ширина от 128 до 2048 пикселей с шагом 64. Укажите вместе с height. Стоимость зависит от размеров. | ||||||||||||
heightrequired | integer | min: 128 · max: 2048 | 1088 | Высота от 128 до 2048 пикселей с шагом 64. Укажите вместе с width. | ||||||||||||
durationrequired | number | min: 1 · max: 20 | 6 | Продолжительность видео в секундах, от 1 до 20. | ||||||||||||
fps | integer | min: 1 · max: 120 | 25 | Частота кадров в секунду, от 1 до 120. | ||||||||||||
CFGScale | number | min: 1 · max: 50 | — | Сила следования prompt (шаг 0.01). ТРЕБУЕТ inputs.audio — без аудио параметр не работает. | ||||||||||||
inputs.frameImages | array of strings or objects | min: 1 · max: 1 | — | Image-to-video. Только 1 элемент — модель поддерживает только first-frame anchoring. 2 формата вводаFormat 1: string[] Image input — URL / UUID / Data URI / Base64. [ "https://example.com/first-frame.jpg" ] Format 2: object[]
[
{
"image": "https://example.com/start.jpg",
"frame": "first"
}
] | ||||||||||||
inputs.audio | string | — | — | Аудио для синхронизации, URL или UUID. Размеры задаются через width и height с шагом 64. примеры значенийПримеры https://example.com/dialogue.wav | ||||||||||||
settings.audio | boolean | — | true | Генерировать ли native audio (dialogue / ambient sound). НЕЛЬЗЯ использовать с inputs.audio (там аудио — вход). | ||||||||||||
numberResults | integer | min: 1 · max: 4 | 1 | Сколько вариаций сгенерировать (разные seeds). Каждая считается отдельно. | ||||||||||||
outputFormat | enum | MP4, WEBM, MOV | MP4 | Контейнер для финального видео. | ||||||||||||
outputQuality | integer | min: 20 · max: 99 | 95 | Качество компрессии (20–99). Выше — лучше визуально и больше размер файла. | ||||||||||||
safety.checkContent | boolean | — | false | Включить проверку контента на NSFW / запрещёнку. При true default-режим safety.mode становится fast. | ||||||||||||
safety.mode | enum | none, fast, full | none | Режим safety-сканера: none — выключен, fast — проверяет ключевые кадры, full — все кадры (медленнее). | ||||||||||||
webhookURL | string | — | — | URL для POST-уведомления при готовности задачи. При numberResults > 1 webhook триггерится на каждый результат отдельно. примеры значенийПримеры https://yourapp.com/webhooks/runware | ||||||||||||
uploadEndpoint | string | — | — | Presigned URL (S3 / GCS / Azure / HTTP PUT) для автозагрузки готового видео. Сырое binary в body PUT-запроса. примеры значенийПримеры https://bucket.s3.amazonaws.com/result.mp4?X-Amz-Signature=... |
Поддерживаемые размеры
Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.
1920×10881088×19201920×10241024×19201280×704704×12801024×10242048×11521152×2048Параметры ответа
Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.
Async (HTTP 202)
HTTP 202. Видео-генерация всегда async — нет sync-режима.
| Поле | Тип | Значения | Описание |
|---|---|---|---|
id | string | — | task_id для GET /v1/tasks/{id}. |
object | string | video.task | |
status | enum | queued, processing, completed, failed | |
model | string | — | |
created | integer | — |
Опрос статуса (GET /v1/tasks/{id})
GET /v1/tasks/{id} — опрос статуса.
| Поле | Тип | Значения | Описание |
|---|---|---|---|
id | string | — | |
status | enum | queued, processing, completed, failed, canceled | |
modality | string | video | |
model | string | — | |
data | array | — | Каждый элемент:
|
error | string | — |
Пример запроса
from openai import OpenAI
client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
model= "ltx-23",
positivePrompt= "Пример промпта",
width= 1920,
height= 1088,
duration= 6,
fps= 25,
CFGScale= 25.5,
numberResults= 1,
outputFormat= "MP4",
outputQuality= 95,
webhookURL= "https://example.com/...",
uploadEndpoint= "value",
inputs= {
"frameImages": [],
"audio": "Пример промпта"
},
settings= {
"audio": True
},
safety= {
"checkContent": False,
"mode": "none"
},
)
print(resp) Замените rk_live_... на ваш ключ из кабинета.