TL;DR
- 可灵 3.0（Kling 3.0）是快手出品的视频模型，在 HiAPI 上有文生视频
kling-3.0/text-to-video和图生视频kling-3.0/image-to-video两个入口，单条 3–15 秒，最高 4K，能开原生声音。打开模型页 就能在线生成，新用户注册送 200 积分。 - 按秒计费：720p 每秒 $0.10，开声音 $0.143；1080p $0.129，开声音 $0.193；4K $0.479。5 秒 720p 只要 $0.50。
- API 两步走：
POST /v1/tasks提交，拿taskId查结果。下面的 curl 和 Python 复制就能跑。
先看效果
文生视频：一段英文提示词，一次请求。
A lone red fox sprints across a windswept snowy ridge at golden hour, powder snow kicking up behind each stride, then leaps over a frozen creek in a graceful arc. Cinematic, dramatic side lighting, ultra-detailed fur, shallow depth of field, smooth motion.
用这个提示词生成 →（5 秒、16:9）
kling-3.0/text-to-video 模型页示例，5 秒。按 720p 关声音算 $0.50，1080p 开声音 $0.965。
图生视频：用下面这张灯塔图当首帧。
The waves surge and crash against the rocks, the lighthouse beam sweeps slowly across the stormy night sky, rain streaks through the wind. Smooth cinematic motion, synchronized ambient sound of waves and storm.
用这个提示词生成 →（上传你的首帧图，5 秒）
kling-3.0/image-to-video 模型页示例，5 秒。按 720p 开声音算 $0.715。
可灵 3.0、Omni、Turbo 怎么选？
HiAPI 上可灵 3.0 有三条线，模型名不同，价格和参数也不同：
| 模型 | 入口 | 720p / 秒 | 1080p / 秒 | 4K / 秒 | 适合 |
|---|---|---|---|---|---|
可灵 3.0 kling-3.0/* | 文生、图生（首帧或首尾帧） | $0.10，开声音 $0.143 | $0.129，开声音 $0.193 | $0.479 | 有声成片、多镜头短片 |
可灵 3.0 Omni kling-3.0-omni/* | 文生、图生、参考生、视频改写 | $0.10，开声音 $0.129 | $0.129，开声音 $0.1645 | $0.479 | 锁定人物/商品、照着参考视频运镜 |
可灵 3.0 Turbo kling-3.0-turbo/* | 文生、图生 | $0.13 | $0.16 | — | 不分声音，只按分辨率计价 |
只要文生、图生，选 kling-3.0；要参考图锁主体、参考视频或改写已有视频，看 可灵 3.0 Omni 中文教程。
两条上手路线
在线试用（不写代码）
- 打开 可灵 3.0 文生视频 模型页，注册或登录。
- 粘贴提示词，选时长、分辨率、画幅，决定要不要声音。
- 点生成，出片后直接下载。
API 调用
- 在控制台创建 API Key。
POST https://api.hiapi.ai/v1/tasks提交任务，返回taskId。GET /v1/tasks/{taskId}查状态，status为success时从output[0].url下载视频。
curl：第一条视频
5 秒 720p 关声音，$0.50：
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0/text-to-video",
"input": {
"prompt": "金色夕阳下，一只红狐在风雪覆盖的山脊上疾奔，雪粉飞扬，电影级侧光，平滑跟拍",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"sound": false
}
}'
返回：
{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}
查结果：
curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
-H "Authorization: Bearer $HIAPI_KEY"
Python：提交、轮询、下载
# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests
KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}
def generate(model, timeout_s=900, **params):
body = {"model": model, "input": params}
# 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
r.raise_for_status()
res = r.json()
if res.get("code") != 200:
raise RuntimeError(res)
task_id = res["data"]["taskId"]
deadline = time.time() + timeout_s
while time.time() < deadline:
d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
if d["status"] == "success":
return d["output"][0]["url"]
if d["status"] == "fail":
raise RuntimeError(d)
time.sleep(10)
raise TimeoutError(task_id)
# 竖屏、带声音的口播短视频
url = generate(
"kling-3.0/text-to-video",
prompt="竖屏短视频：一位博主拿着新耳机对着镜头介绍，手势自然，室内自然光，口型和说话声同步",
duration=6, resolution="1080p", aspect_ratio="9:16", sound=True,
)
with open("clip.mp4", "wb") as f:
f.write(requests.get(url).content)
这条 6 秒 1080p 开声音，$1.158。
图生视频：一张首帧，或首尾两帧
模型名换成 kling-3.0/image-to-video，把图放进 image_urls：1 张是首帧，2 张是 [首帧, 尾帧]。
{
"model": "kling-3.0/image-to-video",
"input": {
"image_urls": [
"https://your-cdn.example.com/start.jpg",
"https://your-cdn.example.com/end.jpg"
],
"prompt": "镜头缓慢推进，两个画面之间平滑过渡",
"duration": 5,
"resolution": "720p",
"sound": false
}
}
- 图片支持 JPEG / PNG / WebP，不支持 SVG。
- 图生视频没有
aspect_ratio，画幅跟随首帧。 - 提示词可选，写「接下来怎么动」，不用重新描述整张图。
参数一览
| 参数 | 取值 | 说明 |
|---|---|---|
prompt | 字符串 | 文生必填，图生可选 |
image_urls | 1–2 张 | 仅图生；1 张首帧，2 张首尾帧 |
duration | 3–15 的整数，默认 5 | 单位秒 |
resolution | 720p / 1080p / 4K，默认 1080p | 不写就按 1080p 计费 |
aspect_ratio | 16:9 / 9:16 / 1:1，默认 16:9 | 仅文生 |
sound | 默认 false | 开启后生成对白、音效和环境声 |
算一下费用
| 时长 | 720p | 720p 开声音 | 1080p | 1080p 开声音 | 4K |
|---|---|---|---|---|---|
| 3 秒 | $0.30 | $0.429 | $0.387 | $0.579 | $1.437 |
| 5 秒 | $0.50 | $0.715 | $0.645 | $0.965 | $2.395 |
| 10 秒 | $1.00 | $1.43 | $1.29 | $1.93 | $4.79 |
| 15 秒 | $1.50 | $2.145 | $1.935 | $2.895 | $7.185 |
resolution 默认是 1080p，调提示词时记得显式写 720p，能省两成多。更多价格对比看 可灵 3.0 API 价格。
上线前注意
- 用回调代替轮询：请求顶层（和
input同级）加"callback": {"url": "https://你的域名/hiapi/callback"}，按taskId去重。 - 及时转存：
output[0].url是临时链接，拿到后马上存到自己的存储。 - 重试带幂等键：请求头加
Idempotency-Key，同一个键重试只创建一次任务。 - 失败自动退款：只按成功生成的视频计费。
常见问题
提示词能写中文吗？
能。中文、英文都可以，对白内容也可以直接写进提示词。
声音要另外付费吗？
sound: true 时单价更高：720p 每秒从 $0.10 到 $0.143，1080p 从 $0.129 到 $0.193。只要画面就保持默认的 false。
一条最长多久？
3–15 秒。更长的片子分段生成后剪辑。
可灵 3.0 和 Seedance 2.5 怎么选？
可灵 3.0 单价低、支持 4K；Seedance 2.5 单条最长 30 秒。对比看 可灵 3.0 和 Seedance 2.5 的区别。
想要现成的写法，看 可灵 3.0 提示词指南；也可以复制上面的红狐提示词，去模型页生成。
