lightricks/ltx-2.3-lora/image-to-video18 點數起 / 5 秒影片· 圖生影片LTX-2.3 LoRA 執行 Lightricks 開源的 220 億參數音影片模型,可載入最多三個你自己的 LoRA 檔案。片長 5 到 20 秒,最高 1080p,帶立體聲配樂,LoRA 可以通過 Hugging Face 或 Civitai 的下載連結載入。
在 POST /jobs/createTask 把模型名稱填成 lightricks/ltx-2.3-lora/image-to-video 就能呼叫,18 點數/ 5 秒影片起(US$0.18)。新帳戶送 30 點數,可以先在 Playground 免費試用。
- 生成影片
- 圖生影片
- 最高 1080p
- 5–20 秒
- 可載入自己的 LoRA
lightricks/ltx-2.3-lora/image-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.3-lora/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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.3-lora/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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.3-lora/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 依下方的 Schema 產生,原樣就能通過驗證。把提示詞和連結換成你自己的即可。
價格
| 選項 | 點數 /秒 | ≈ 美元 |
|---|---|---|
resolution 480p | 3.6 | US$0.036 |
resolution 720p | 5.4 | US$0.054 |
resolution 1080p | 7.2 | US$0.072 |
1 點數 = $0.01 · 全部選項及價格:GET /models/lightricks/ltx-2.3-lora/image-to-video
限制
- 影片長度
- 5–20 s
- 解析度
- 480p · 720p · 1080p
參數
這些欄位來自我們驗證每個請求所用的同一份 Schema。沒列出的欄位會被拒絕。
promptstring必填Describe what happens after the opening frame: the action, the camera and the sound. Put LoRA trigger words first.
image_urlstring必填作為起點的那張圖。
resolutionstring選填影響價格輸出尺寸。越大越清晰,價格也越高。
duration_secondsinteger選填影響價格影片長度,按秒計費。
lorasarray<object>選填載入你自己的 LoRA,鎖定風格或角色。
內部欄位
loras[].pathstring必填Direct URL of a LoRA weights file (a Hugging Face file link or a Civitai download link).
loras[].scalenumber必填Weight strength from zero to four.
seedinteger選填用同一個數字,結果就能重現。
原始 JSON Schema
{
"additionalProperties": false,
"properties": {
"duration_seconds": {
"default": 5,
"description": "Requested output length in whole seconds, from 5 to 20.",
"maximum": 20,
"minimum": 5,
"type": "integer"
},
"image_url": {
"contentMediaType": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif"
],
"description": "Opening frame. The clip starts from this image and keeps its aspect ratio.",
"format": "uri",
"type": "string"
},
"loras": {
"default": [],
"description": "Up to three LoRA weight files trained for LTX-2.3, 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 (a Hugging Face file link or a Civitai download link).",
"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 what happens after the opening frame: the action, the camera and the sound. Put LoRA trigger words first.",
"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",
"image_url"
],
"type": "object"
}LTX-2.3 LoRA 的真實成品
Claymation diorama style, handcrafted stop-motion animation: the man lying on the planetarium floor turns into a sculpted clay figure as the projected eclipse slides across him; he stretches, smiles up into the lens and reaches one hand toward the camera while tiny clay stars drift down around him. Overhead camera slowly rotates. Silver and navy clay, visible fingerprints. Audio: a gentle chime, soft clay squeak.
{
"model": "lightricks/ltx-2.3-lora/image-to-video",
"input": {
"prompt": "Claymation diorama style, handcrafted stop-motion animation: the man lying on the planetarium floor turns into a sculpted clay figure as the projected eclipse slides across him; he stretches, smiles up into the lens and reaches one hand toward the camera while tiny clay stars drift down around him. Overhead camera slowly rotates. Silver and navy clay, visible fingerprints. Audio: a gentle chime, soft clay squeak.",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5,
"seed": 4214
}
}這則是從上傳的檔案開始的:把範例連結換成你自己的檔案連結。
回應、輪詢與回呼
所有模型的用法都一樣:先建立任務,再輪詢,或等待回呼。
先報價
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.3-lora/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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.3-lora/image-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"
}請在 expiresAt 之前從 url 下載。之後需要新連結,請呼叫 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。

