可灵4.0 API 什么时候能用？用 hiapi 在售 Kling 3.0 Turbo/Omni 今天就能接

可灵 4.0 到底上线了没有？

先把结论放前面：截至 2026-10-02，可灵 4.0（Kling 4.0）在 hiapi 还没有可调用的 API。这不是凭印象判断——我们实时查了两处权威数据源：

1. /v1/models 模型清单里完全搜不到任何 kling-4 开头的条目，连一个 coming_soon: true 的占位符都没有；
2. 定价页 的全部模型定价数据里同样没有可灵 4.0 的记录。

也就是说可灵 4.0 现在连"预告位"都算不上，大概率还在官方内测阶段，什么时候对第三方开放 API 没有时间表。如果你是被"可灵4.0"这个关键词的热度带过来、想赶紧接上最新一代可灵能力做视频生成，那等官方放出来黄花菜都凉了——好消息是可灵 3.0 系列（Turbo / Omni）已经在 hiapi 全量可用，无论是文生视频、图生视频还是多参考图合成，3.0 这一代基本覆盖了 4.0 发布前你能想到的大部分场景。

下面直接上手，用真实调用把两个模型的差异、价格、代码示例都讲清楚。

Kling 3.0 Turbo vs Omni：怎么选

两个模型都通过 hiapi 统一的异步任务接口 POST /v1/tasks 调用（创建任务 → 轮询 GET /v1/tasks/{id} → 从返回的 output[0].url 取结果），账号、鉴权、轮询逻辑完全一致，区别全在 model 字段和 input 参数上。

一句话版选择建议：

• 只是要稳定出一条 720p/1080p 的短视频、追求低成本和简单参数 → 选 Turbo。它的 720p 档反而比 Omni 同档贵（$0.13 vs $0.10/秒），但参数更少、行为更可预测，适合批量跑标准交付物。
• 需要 4K 成片、需要视频自带可选配音、或者要用多张参考图合成一致性角色/场景 → 选 Omni。它是目前 hiapi 上唯一能出 4K 视频、唯一能开关配音的可灵模型。

真实调用示例

下面几段 curl 的字段名和取值范围都是今天用无效参数探测接口报错信息实测确认的（比如拿 duration: -1 和 duration: 9999 分别探出 Omni 的下限/上限是 3 和 15），不是抄文档或凭记忆写的。

Turbo 文生视频

详细字段说明见 kling-3.0-turbo 文生视频模型页：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo/text-to-video",
    "input": {
      "prompt": "一只金毛犬在夕阳下的沙滩上奔跑，慢镜头，电影感光影",
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "16:9"
    }
  }'

Turbo 图生视频

图生视频端点不接受 aspect_ratio——画幅直接跟随你传入的参考帧，image_urls 只认一张：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo/image-to-video",
    "input": {
      "prompt": "镜头缓慢推进，画面中的云层开始流动",
      "image_urls": ["https://example.com/your-frame.jpg"],
      "duration": 5,
      "resolution": "1080p"
    }
  }'

Omni 文生视频（4K + 配音）

Omni 文生视频独有的 sound 字段是布尔值，打开后会按带音效的那一档计费（1080p 从 $0.129/秒跳到 $0.193/秒）：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni/text-to-video",
    "input": {
      "prompt": "赛博朋克风格的控制室，全息仪表盘缓缓展开，环境音效",
      "duration": 4,
      "resolution": "4K",
      "aspect_ratio": "16:9",
      "sound": true
    }
  }'

Omni 图生视频的参数范围和计费与文生视频完全一致，只是把 prompt 换成 prompt + image_urls。Omni 还有第三个端点 kling-3.0-omni/reference-to-video，它不吃 image_urls，而是用 kling_elements 数组做多参考图合成（比如固定角色+固定场景拼到一起生成），适合需要跨镜头保持角色一致性的场景——这个端点目前定价页还没有单独列出价格，正式使用前建议先确认计费口径。

实拍效果：3 秒 Turbo 文生视频

下面是用上面同款 Turbo 文生视频接口、720p/16:9 实际跑出来的一条 3 秒片段，没有经过二次剪辑：

VIDEO

可以看到即便是最便宜的 720p 档位，运镜和光影也相当稳定，没有明显的闪烁或形变，而且像 Omni 一样自带真实环境音轨——这也是为什么日常批量生产场景下，Turbo 往往比一上来就冲 Omni 4K 更划算。

常见问题

可灵 4.0 什么时候能通过 API 调用？ 没有官方时间表。hiapi 会在模型正式开放后第一时间上架，建议直接收藏定价页，上线会第一时间同步。

Turbo 和 Omni 能混用吗？比如先用 Turbo 出草稿，确认分镜后再用 Omni 出终稿？ 可以，两者走的是同一套任务接口和鉴权，唯一要改的就是 model 字段和对应的 input 参数，不需要额外对接成本。这也是很多团队实际的工作流：Turbo 低成本打样，Omni 4K 出正片。

Omni 的 4K 档位值得为了画质直接上吗？ 看场景。如果最终要发到短视频平台（大多数平台会把画面压缩到 1080p 甚至更低），4K 的画质收益会被平台压缩吃掉大半，但 $0.479/秒的价格接近 1080p+配音档位的 2.5 倍；只有确实要做大屏展示、宣传片这类对分辨率敏感的素材，4K 才划算。

除了可灵，hiapi 上还有哪些视频模型可以参考对比？ 可以看看我们之前写的 Seedance 2.5 详解，同样是任务制接口，价格结构和可灵有相似也有不同，适合横向比价。

现在就能接，不用等官方放量

可灵 4.0 还在官方的黑箱里，但 hiapi 上的 Kling 3.0 Turbo / Omni 已经是生产可用的状态——同一套 /v1/tasks 接口，一个 API Key 就能跑通文生视频、图生视频、4K 配音生成。想先跑通上面任意一段 curl 示例，直接去快速入门文档注册拿 Key 就能开始。