lightricks/ltx-2-19b-lora/text-to-videoОт 14 кредитов за клип длиной 5 с· Создать видеоLTX-2 19B LoRA запускает открытую аудио-видеомодель Lightricks с тремя вашими файлами LoRA на запрос, в text-to-video и image-to-video. Клипы идут от 5 до 20 секунд в 480p, 720p или 1080p со стереозвуком.
Вызывайте его по имени модели lightricks/ltx-2-19b-lora/text-to-video через POST /jobs/createTask, от 14 кредитов за клип длиной 5 с (0,14 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.
- Создать видео
- Видео из картинки
- До 1080p
- Ролики 5–20 с
- Свои LoRA
lightricks/ltx-2-19b-lora/text-to-videoPOST https://api.popnow.ai/api/v1/jobs/createTask# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "lightricks/ltx-2-19b-lora/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"// Node 18+ (or any runtime with fetch). Keep the API key on your server.
const BASE = "https://api.popnow.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
async function call(path, init = {}) {
const res = await fetch(BASE + path, { ...init, headers: { ...headers, ...init.headers } });
const body = await res.json();
if (body.code !== 200) throw new Error(`${body.code} ${body.msg}`);
return body.data;
}
const { taskId } = await call("/jobs/createTask", {
method: "POST",
headers: { "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
body: JSON.stringify({
"model": "lightricks/ltx-2-19b-lora/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}),
});
// Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
let task;
for (let delay = 2000; ; delay = Math.min(delay * 1.5, 15000)) {
await sleep(delay);
task = await call(`/jobs/recordInfo?taskId=${taskId}`);
const copying = (task.output?.assets ?? []).some((a) => a.pending && !a.unavailable);
if (["succeeded", "failed", "canceled", "expired"].includes(task.state) && !copying) break;
}
if (task.state !== "succeeded") throw new Error(`${task.state}: ${task.errorMessage ?? "no detail"}`);
// Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for (const asset of task.output.assets) console.log(asset.url);import os, time, uuid, requests
BASE = "https://api.popnow.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}
def call(method, path, **kwargs):
body = requests.request(method, BASE + path, headers={**HEADERS, **kwargs.pop("headers", {})}, timeout=30, **kwargs).json()
if body["code"] != 200:
raise RuntimeError(f'{body["code"]} {body["msg"]}')
return body["data"]
task_id = call(
"POST",
"/jobs/createTask",
headers={"Idempotency-Key": str(uuid.uuid4())}, # reuse it if you retry
json={
"model": "lightricks/ltx-2-19b-lora/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
},
)["taskId"]
# Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
delay = 2.0
while True:
time.sleep(delay)
task = call("GET", "/jobs/recordInfo", params={"taskId": task_id})
assets = (task.get("output") or {}).get("assets") or []
copying = any(a.get("pending") and not a.get("unavailable") for a in assets)
if task["state"] in ("succeeded", "failed", "canceled", "expired") and not copying:
break
delay = min(delay * 1.5, 15.0)
if task["state"] != "succeeded":
raise RuntimeError(f'{task["state"]}: {task.get("errorMessage", "no detail")}')
# Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for asset in assets:
print(asset["url"])input собран по схеме ниже, поэтому проходит проверку как есть. Замените промпт и ссылки на свои.
Цена
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
resolution 480p | 2,7 | 0,027 $ |
resolution 720p | 3,6 | 0,036 $ |
resolution 1080p | 5,4 | 0,054 $ |
1 кредит = 0,01 $ · Все варианты и цены: GET /models/lightricks/ltx-2-19b-lora/text-to-video
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 14 кредитов за клип длиной 5 с (0,14 $).
Ограничения
- Длина клипа
- 5–20 s
- Разрешения
- 480p · 720p · 1080p
- Соотношения сторон
- 16:9 · 9:16
Параметры
Эти поля взяты из той же схемы, по которой мы проверяем каждый запрос. Поля, которых нет в списке, отклоняются.
promptstringОбязательноеDescribe the scene, the action, the camera and the sound. Put the soundtrack on its own Audio: line.
aspect_ratiostringНеобязательноеФорма кадра: широкая, квадратная или вертикальная.
resolutionstringНеобязательноеВлияет на ценуРазмер результата. Больше — чётче и дороже.
duration_secondsintegerНеобязательноеВлияет на ценуДлина ролика. Оплата посекундная.
lorasarray<object>НеобязательноеЗагрузите свои LoRA, чтобы закрепить стиль или персонажа.
Вложенные поля
loras[].pathstringОбязательноеDirect URL of a LoRA weights file.
loras[].scalenumberОбязательноеWeight strength from zero to four.
seedintegerНеобязательноеОдно и то же число даёт повторяемый результат.
Исходная JSON-схема
{
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"default": "16:9",
"description": "Output aspect ratio.",
"enum": [
"16:9",
"9:16"
],
"type": "string"
},
"duration_seconds": {
"default": 5,
"description": "Requested output length in whole seconds, from 5 to 20.",
"maximum": 20,
"minimum": 5,
"type": "integer"
},
"loras": {
"default": [],
"description": "Up to three LoRA weight files trained for LTX-2 19B, each with its own strength. Files over 2 GiB are rejected.",
"items": {
"additionalProperties": false,
"properties": {
"path": {
"contentMediaType": [
"application/octet-stream"
],
"description": "Direct URL of a LoRA weights file.",
"format": "uri",
"minLength": 1,
"type": "string"
},
"scale": {
"default": 1,
"description": "Weight strength from zero to four.",
"maximum": 4,
"minimum": 0,
"type": "number"
}
},
"required": [
"path",
"scale"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"prompt": {
"description": "Describe the scene, the action, the camera and the sound. Put the soundtrack on its own Audio: line.",
"minLength": 1,
"type": "string"
},
"resolution": {
"default": "720p",
"description": "Output resolution.",
"enum": [
"480p",
"720p",
"1080p"
],
"type": "string"
},
"seed": {
"description": "Random seed for controlled comparisons, not a frame-identical guarantee.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
}
},
"required": [
"prompt"
],
"type": "object"
}Настоящий результат LTX-2 19B LoRA
Midnight on a stone terrace cut into a cliff high above the sea, lit only by a full moon. An adult North African man in his early forties with silver at his temples, black tuxedo with the jacket open, white shirt open at the collar and bow tie undone, leans on the stone balustrade; a woman in a long midnight-blue silk gown reaches into frame and takes the glass from his fingers, and he turns toward her with a slow grin. The camera dollies out to reveal the whole terrace, the cliff and the silver path of moonlight on the black water far below. Cold silver-blue moonlight, deep shadows, anamorphic, film grain. Audio: waves breaking on the rocks far below, cicadas, a faint dance band drifting from a villa along the coast, the clink of a glass.
{
"model": "lightricks/ltx-2-19b-lora/text-to-video",
"input": {
"prompt": "Midnight on a stone terrace cut into a cliff high above the sea, lit only by a full moon. An adult North African man in his early forties with silver at his temples, black tuxedo with the jacket open, white shirt open at the collar and bow tie undone, leans on the stone balustrade; a woman in a long midnight-blue silk gown reaches into frame and takes the glass from his fingers, and he turns toward her with a slow grin. The camera dollies out to reveal the whole terrace, the cliff and the silver path of moonlight on the black water far below. Cold silver-blue moonlight, deep shadows, anamorphic, film grain. Audio: waves breaking on the rocks far below, cicadas, a faint dance band drifting from a villa along the coast, the clink of a glass.",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5,
"seed": 540522
}
}Ответы, опрос и колбэки
Все модели работают одинаково: создайте задачу, а затем опрашивайте её или дождитесь колбэка.
Сначала узнайте цену
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "lightricks/ltx-2-19b-lora/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'То же тело, что и у createTask. Возвращает ожидаемое и максимально возможное списание и ничего не запускает.
Принято
HTTP/1.1 202 Accepted
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued"
},
"request_id": "req_example_create"
}HTTP 202 означает, что задача принята, а кредиты зарезервированы, но ещё не списаны. Итоговое списание никогда не превысит резерв.
Проверка статуса
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Опрашивайте каждые несколько секунд, постепенно увеличивая паузу, и остановитесь, когда state станет succeeded, failed, canceled или expired.
Готовая задача
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "lightricks/ltx-2-19b-lora/text-to-video",
"state": "succeeded",
"output": {
"assets": [
{
"url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
"expiresAt": "2026-10-17T12:20:00Z",
"mime": "video/mp4",
"width": 1280,
"height": 720,
"durationSeconds": 5
}
]
},
"settled": true
},
"request_id": "req_example_record"
}Скачайте файл по url до expiresAt. Нужна новая ссылка позже? Запросите её через POST /common/download-url.
Проверка колбэка
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";
const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
const timestamp = req.header("X-Webhook-Timestamp");
const signature = req.header("X-Webhook-Signature") ?? "";
const body = JSON.parse(req.body.toString("utf8"));
const taskId = body.data?.taskId ?? body.task_id;
const digest = createHash("sha256").update(req.body).digest("hex");
const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
.update(`${taskId}.${timestamp}.${digest}`)
.digest("base64");
const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
// Check the signature first, then reject anything older than five minutes.
if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
res.status(200).end(); // answer fast, then fetch the task and store its files
});Если задан callBackUrl, мы пришлём вам готовую задачу. Прежде чем доверять ей, проверьте подпись по исходному телу запроса.
Отправка локального файла
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contentType": "image/png", "bytes": 482113}'
# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
-H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.Публичные https-ссылки работают как есть. Локальные файлы сначала проходят через upload-url и commit.

