如何使用 ltx-2.5/image-to-video 图片转视频 API:图生视频接入指南(2026)

2 min · 更新于 2026-07-11 · NamiFusion 团队

ltx-2.5/image-to-video 图片转视频 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。

ltx-2.5/image-to-video 图片转视频 是一款图生视频模型(由 Ltx 2.5 提供):LTX 2.5 图片转视频可将首帧图片动画化,生成高保真、音视频同步的内容,并支持可选的末帧引导以及 720P / 1080P / 2K / 4K 输出,适用于电影感视频、社交内容、广告和制作流程。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.500。

TL;DR

· 任务类型:图生视频,由 Ltx 2.5 提供

· 价格:典型一次调用约 $0.500($1 = 100 积分),按量计费无订阅

· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入

· 可调参数:6 个(见下方参数表)

· 无平台水印,商用可用(遵守服务条款)

用 ltx-2.5/image-to-video 图片转视频 能做什么?

短视频与广告片段:从一句话或一张图直接产出可发布的动态素材。

产品演示与概念预览:低成本验证分镜和视觉方向,再决定是否实拍。

社媒内容工厂:批量生成竖屏短片,配合热点话题快速上线。

已有素材的二次创作:图生视频让静态作品动起来,延长内容生命周期。

怎么调用这个 API?

  1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
  2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
  3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
提交任务
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/ltx-2.5/image-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic slow push-in on a futuristic electric sports car parked on a rain-soaked neon city street at night, reflections shimmering on the pavement, subtle steam rising from vents, soft camera motion, realistic lighting, highly detailed, atmospheric, smooth natural motion",
    "image": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/09/16/fe9c5bb479a2.jpeg"
    ],
    "last_image": [],
    "resolution": "720p",
    "duration": 5,
    "seed": -1
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

有哪些参数?

prompt(提示词):必填

image(图片):必填

last_image(最后一帧图片):可选

resolution(分辨率):可选,默认 "720p"

duration(时长):可选,默认 5

seed(随机种子):可选,默认 -1

ltx-2.5/image-to-video 图片转视频 的提示词怎么写?

  1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
  2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
  3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
  4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。

价格是多少?

按次积分计价,典型一次调用约 $0.500($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。

ltx-2.5/image-to-video 图片转视频

生成音画同步视频。时长为 5~20 的整数秒,分辨率支持 720p、1080p、2k、4k。默认 720p、5 秒,seed=-1 表示随机种子。 Nami 的 image 为必填单图 URL 数组,last_image 为可选单图 URL 数组。首帧已预填示例,末帧默认留空。

价格

ResolutionUSD / secondCredits / second
720p$0.1010
1080p$0.1414
2k$0.2121
4k$0.3333

Default 720p × 5 s = $0.50 = 50 credits.

与 WaveSpeed 官方标准价一致;1 美元 = 100 积分。账户专属折扣另行计算。

API

curl -X POST 'https://www.namifusion.com/api/v1/marketplace/run/ltx-2.5/image-to-video' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "prompt": "A cinematic slow push-in on a futuristic electric sports car parked on a rain-soaked neon city street at night, reflections shimmering on the pavement, subtle steam rising from vents, soft camera motion, realistic lighting, highly detailed, atmospheric, smooth natural motion",
    "image": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/09/16/fe9c5bb479a2.jpeg"
    ],
    "resolution": "720p",
    "duration": 5,
    "seed": -1
  }
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

提交响应包含 task_uuid;轮询直至 completed 或 failed。成功结果字段为 output.videos (URL array).

WaveSpeed official model

常见问题

可以先免费试用吗?+

注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。

生成内容可以商用吗?有水印吗?+

可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。

内容政策是什么?+

色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许,详见服务条款。

ltx-2.5/image-to-video 图片转视频 的任务要跑多久?+

取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。

分辨率/时长上限是多少?+

以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。