跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Kling 2.5 Turbo Image-to-Video

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型 ID kling-2.5-turbo/image-to-video
类型 视频生成（图生视频）
接口 POST /v1/tasks
价格 见 HiAPI 定价

从首帧生成 5 秒或 10 秒视频，可添加尾帧引导结束画面；输出不含音轨。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

首尾帧衔接

用首帧建立场景，用尾帧引导结束画面。

promptimage_urls
横屏、竖屏与方形

按发布位置安排画面构图。

aspect_ratio

请求参数

model string 必填

固定填 kling-2.5-turbo/image-to-video.

示例 kling-2.5-turbo/image-to-video
input object 必填

视频生成参数。

prompt string 必填

描述主体动作、环境变化与镜头运动，1–2500 字符。

image_urls string[] 必填

按 [首帧, 尾帧] 顺序传入 1–2 张图片；第二张引导结束画面。支持 jpeg/png/webp，单张最大 10MB，不支持 SVG。

duration enum 可选

生成视频的时长（秒）。

默认 5 可选值: 510
aspect_ratio enum 可选

视频的宽高比；添加尾帧后仅支持 16:9、9:16、1:1。

默认 16:9 可选值: 16:99:161:14:33:421:9
negative_prompt string 可选

描述不希望出现的内容，最长 2496 字符。

cfg_scale number 可选

调整对提示词的遵循程度，范围 0–1。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

风暴中的灯塔

首帧建立场景，提示词描述浪花、光束与缓慢推镜。

请求体
{
  "model": "kling-2.5-turbo/image-to-video",
  "input": {
    "prompt": "Waves crash against the rocks below, the lighthouse beam sweeps slowly across the storm clouds, mist drifts over the sea, slow cinematic push-in",
    "image_urls": [
      "https://dev-static.hiapi.ai/gallery/2026/10/f0ee80f89b4a25cc.jpg"
    ],
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的视频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

首尾帧怎样搭配画幅？

添加尾帧时选择 16:9、9:16 或 1:1；仅用首帧时还可选 4:3、3:4、21:9。让主体靠近图片中央，避免裁切关键细节。

可以更改分辨率吗？

没有分辨率选择项。1:1 输出 1440×1440，16:9 输出 1920×1080，9:16 输出 1080×1920。 4:3 为 1660×1244，3:4 为 1244×1660，21:9 为 2200×940。

视频有声音吗？

输出不含音轨，请在后期添加配音、音乐或音效。

下一步