可灵 4.0 图生视频

kwaivgi/kling-v4.0/image-to-video

将首帧生成视频，可选末帧与有序中间帧，合计最多 10 张；支持 3–30 秒及 720p、1080p。

示例

参数

名称	类型	默认	约束	说明
image *首帧	image_upload	—	image/jpeg,image/png · 1–1 items	首帧图片，支持 JPG、JPEG 和 PNG。
prompt提示词	textarea	—	≤ 5000 chars	描述运动的文本提示词（可留空）。
last_image尾帧	image_upload	—	image/* · 0–1 items	最后一帧图片 URL。需要提供图片。
keyframes有序中间帧	image_upload	—	image/* · 0–9 items	按顺序排列的中间帧，需先提供首帧。首帧、尾帧和中间帧合计最多 10 张。
resolution分辨率	select	720p	720p \| 1080p	输出分辨率。
duration时长	select	5	3 ~ 30 · step 1 · 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10 \| …	生成视频的时长（秒）（3-30）。
aspect_ratio宽高比	select	—	16:9 \| 9:16 \| 1:1 \| 21:9	输出视频的宽高比；留空时跟随首帧。

输出字段

字段	类型	说明
videos	array<string>

API

通过统一 REST API 调用本模型；在 API Keys 页获取密钥。

cURL

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

Python

import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/image-to-video",
    headers=HEADERS,
    json={
        "input": {
            "image": "https://example.com/input.jpg",
            "resolution": "720p",
            "duration": 5
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))

JavaScript

const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/image-to-video", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "image": "https://example.com/input.jpg",
      "resolution": "720p",
      "duration": 5
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

文档

Kling 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。以上为标价，不计促销折扣。

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

MaaS 参数映射

Nami 的 image[0] 映射为 MaaS 的 image 字符串，last_image[0] 映射为 last_image 字符串；keyframes 保留字符串数组。未提供的可选图片字段直接省略。其余已列字段在 MaaS 中保持同名；duration 必须为整数，支持 keep_original_sound 的接口使用布尔值。数组顺序保持不变。

Nami API

使用 Authorization: Bearer YOUR_NAMI_API_KEY 和 Content-Type: application/json，向以下地址发送 POST 请求：

https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/image-to-video

请求体示例：

{
  "input": {
    "image": [
      "https://example.com/first-frame.jpg"
    ],
    "last_image": [
      "https://example.com/last-frame.jpg"
    ],
    "keyframes": [
      "https://example.com/middle-frame.jpg"
    ],
    "prompt": "The person slowly turns toward the window, then smiles. Smooth camera movement and quiet room ambience.",
    "resolution": "720p",
    "duration": 5
  }
}

请将 example.com 地址替换为可公开访问的素材 URL。取得 task_uuid 后，使用相同鉴权轮询 GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}。成功后从 output.videos 读取生成视频 URL 数组。