快手可灵 Kling 视频生成 SDK

用途：把本文件发给任意 AI 工具（Claude / ChatGPT / Deepseek 等），AI 即可调用 naapi.cc 生成可灵（Kling）视频。
版本：v1
时间：2026-08-02
作者：钠 API 鈉 API | ナトリウム API - 王曉婷
归属：https://naapi.cc/ - 中國台灣鈉雲網路科技 · P.R.C Taiwan NaCloud Network Technology Co., Ltd.
本文件不含密钥；调用方必须自行写入 API Key。

1. 快速开始（三段 curl，即可出片）

2. 鉴权

Base URL：https://naapi.cc/v1

请求头：Authorization: Bearer <API_KEY>

API Key 属于用户私有凭据，不得写入代码、文档、日志或对话记录。

3. 异步任务协议

3.1 提交任务

POST https://naapi.cc/v1/videos
Content-Type: application/json
Authorization: Bearer <API_KEY>

请求体：

{
  "model": "kling-3.0-omni-1080p",
  "prompt": "一只蓝色小球从左向右缓缓移动，纯白背景",
  "duration": 5,
  "size": "1920x1080"
}

字段说明：

字段	必填	说明
`model`	是	`kling-3.0-omni-1080p`（0.04/秒）
`prompt`	是	视频内容描述
`duration`	否	视频秒数；不传默认 4 秒（按秒计费）
`size`	否	`1920x1080`（1080p）或 `1280x720`（720p）；不传默认 `720x1280`

提交响应（HTTP 200，任务已受理）：

{
  "id": "task_xxxx",
  "task_id": "task_xxxx",
  "object": "video",
  "model": "kling-3.0-omni-1080p",
  "status": "queued",
  "progress": 0,
  "created_at": 1785636411,
  "seconds": "5",
  "size": "1920x1080"
}

3.2 轮询状态

GET https://naapi.cc/v1/videos/<task_id>
Authorization: Bearer <API_KEY>

状态机：

queued → in_progress → completed（成功）
                      └→ failed（失败，读取 error 信息）

完成态响应示例：

{
  "id": "task_xxxx",
  "task_id": "0d93f2f663204d02b36cf275d53841f0",
  "object": "video",
  "model": "kling-3.0-omni-1080p",
  "status": "completed",
  "progress": 100,
  "seconds": "5",
  "size": "1920x1080",
  "url": "https://download2.bnq777.xyz/generated/xxxx.mp4",
  "video_url": "https://download2.bnq777.xyz/generated/xxxx.mp4",
  "download_url": "https://download2.bnq777.xyz/generated/xxxx.mp4"
}

url / video_url / download_url 指向同一文件，任取其一。

3.3 下载成片

GET https://naapi.cc/v1/videos/<task_id>/content
Authorization: Bearer <API_KEY>

成功：HTTP 200，Content-Type: video/mp4，响应体即 MP4 文件。

任务未完成时访问会报错，必须等 completed 再下载。

4. 给 AI 的硬性规则（重要，防烧钱）

提交一次后，绝不重复提交。拿到 task_id 后只能轮询同一个 ID。重复提交会重复计费。

轮询间隔 10–15 秒；单次任务实测 720p 约 1–3 分钟、1080p 约 4–5 分钟，耐心等待，不要过早放弃。

任务失败（failed）时：读取错误信息并告知用户，不要自动重试。

必须等待 completed 才能下载。

生成前向用户确认费用：价格 = 每秒价格 × duration（1080p 0.04/秒）。

5. 错误处理

现象	处理
提交返回 400/401/429	按 `error.message` 提示用户；不要重试同参数
轮询返回 `failed`	读取错误原因，告知用户，不自动重试
网络超时（curl 28）	可重试轮询（不重试提交）
余额不足	提示用户充值

6. Python 样例代码

依赖：pip install requests。API Key 只从环境变量 NAAPI_API_KEY 读取。

快手可灵 Kling 视频生成 SDK

1. 快速开始（三段 curl，即可出片）#

2. 鉴权#

3. 异步任务协议#

3.1 提交任务#

3.2 轮询状态#

3.3 下载成片#

4. 给 AI 的硬性规则（重要，防烧钱）#

5. 错误处理#

6. Python 样例代码#