如何使用 可灵 4.0 图生视频 API:图生视频接入指南(2026)

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

可灵 4.0 图生视频 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。

可灵 4.0 图生视频 是一款图生视频模型(由 Kling 提供):将首帧生成视频,可选末帧与有序中间帧,合计最多 10 张;支持 3–30 秒及 720p、1080p。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.785。

TL;DR

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

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

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

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

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

用 可灵 4.0 图生视频 能做什么?

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

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

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

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

怎么调用这个 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/kwaivgi/kling-v4.0/image-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "image": "https://example.com/input.jpg",
    "resolution": "720p",
    "duration": 5
  }
}'

# 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"

有哪些参数?

image(首帧):必填

prompt(提示词):可选

last_image(尾帧):可选

keyframes(有序中间帧):可选

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

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

aspect_ratio(宽高比):可选

可灵 4.0 图生视频 的提示词怎么写?

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

价格是多少?

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

可灵 4.0 图生视频

以首帧图片生成 3–30 秒视频和原生立体声音频,可用末帧及按顺序排列的中间帧控制变化过程。

输入参数

  • image:必填 URL 数组,恰好包含 1 张首帧图片;支持 JPG、JPEG、PNG。
  • prompt:可选字符串,可省略或为空。
  • last_image:可选 URL 数组,最多 1 张末帧图片。
  • keyframes:可选、有序的图片 URL 数组,最多 9 张;有末帧时最多 8 张。
  • resolution:"720p"(默认)或 "1080p"。
  • duration:3–30 的整数,默认 5。
  • aspect_ratio:可选 "16:9"、"9:16"、"1:1"、"21:9"。省略时跟随首帧,不要传 "auto"。

限制与引用方式

首帧、末帧与 keyframes 合计不得超过 10 张。中间帧按数组顺序使用。提示词描述运动和声音;不提供单独的 sound 开关。

标价与预扣积分

720p:每输出秒 $0.157;1080p:每输出秒 $0.235。

费用 = 输出秒数 × 对应分辨率单价。5 秒视频在 720p 下为 $0.785,在 1080p 下为 $1.175。

1 美元 = 100 Nami 积分。总积分向上取整到 0.01:积分 = ceil(美元费用 × 10000) / 100。以上为标价,不计促销折扣。

首帧、末帧和中间帧图片均无额外收费。

常见问题

可以先免费试用吗?+

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

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

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

内容政策是什么?+

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

可灵 4.0 图生视频 的任务要跑多久?+

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

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

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