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-video
端點POST 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"

input 依下方的 Schema 產生,原樣就能通過驗證。把提示詞和連結換成你自己的即可。

價格

選項點數 /秒≈ 美元
resolution 480p3.6US$0.036
resolution 720p5.4US$0.054
resolution 1080p7.2US$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.

    範圍
    1 – … chars
  • image_urlstring必填

    作為起點的那張圖。

    範圍
    image/jpeg, image/png, image/webp, image/gif
  • resolutionstring選填影響價格

    輸出尺寸。越大越清晰,價格也越高。

    預設值
    "720p"
    可用值
    "480p""720p""1080p"
  • duration_secondsinteger選填影響價格

    影片長度,按秒計費。

    預設值
    5
    範圍
    5 – 20
  • lorasarray<object>選填

    載入你自己的 LoRA,鎖定風格或角色。

    預設值
    []
    範圍
    0 – 3 items
    內部欄位
    • loras[].pathstring必填

      Direct URL of a LoRA weights file (a Hugging Face file link or a Civitai download link).

      範圍
      1 – … chars · application/octet-stream
    • loras[].scalenumber必填

      Weight strength from zero to four.

      預設值
      1
      範圍
      0 – 4
  • seedinteger選填

    用同一個數字,結果就能重現。

    範圍
    0 – 2147483647
原始 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.
透過 API 送出的同一個請求
{
  "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
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
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 代表任務已受理,點數先凍結、尚未扣除。最終扣款不會超過凍結額。

查詢狀態

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

每隔幾秒查詢一次並逐步拉長間隔,state 變成 succeeded、failed、canceled 或 expired 時停止。

完成的任務

JSON
{
  "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。

驗證回呼

Node.js
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
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。