Skip to main content
POST
/
kling
/
v1
/
videos
/
image2video
cURL
curl --request POST \
+  --url https://api.deerapi.com/kling/v1/videos/image2video \
+  --header 'Authorization: Bearer <DEERAPI_KEY>' \
+  --header 'Content-Type: application/json' \
+  --data '{
    "model_name": "kling-v2-master",
    "image": "https://example.com/start-frame.png",
    "prompt": "镜头缓慢推近,人物抬头微笑。",
    "duration": "5",
    "mode": "pro",
    "callback_url": "https://example.com/kling/callback"
  }'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "videos": {
        "id": "<string>",
        "url": "<string>",
        "duration": "<string>"
      }
    },
    "created_at": 123,
    "updated_at": 123
  }
}
/kling/v1/videos/image2video 适合把一张静态图扩展成连续镜头。海报、商品图、角色设定图已经明确时,通常先从这页开始。

推荐流程

1

先准备一张稳定的首帧

首个请求优先使用可访问的图片 URL。切到 Base64 时,只传原始编码,不要带 data:image/...;base64, 前缀。
2

先交最小任务

先保留 image,再按需要补 promptdurationmodel_name。第一次排错时,不要同时变更图片、模型版本和控制参数。
3

只有需要收尾控制时再加尾帧

image_tail 适合定义镜头结尾的姿态或构图,不适合拿来替代多图参考工作流。
4

保存任务并取结果

创建成功后保存 task_id。你可以用 查询任务 轮询,也可以直接配置 Callback 协议
kling_video 是 DeerAPI capability,不是请求体里的 model_name。如果你要固定 Kling 版本,请显式传官方模型名。

容易踩坑的地方

  • imageimage_tail 当成两套独立参考图集来用。
  • 还没拿到最终产物,就把 task_id 当成 video_id 交给下游流程。
  • 一开始就启用遮罩或其他高级控制,导致首轮排错信息不够集中。

相关页面

多图参考生视频

需要多张主体图维持角色或商品一致性时看这里。

视频延长

已经生成出第一段视频后,继续往后续写时使用。

查询任务

图生视频属于通用 Kling 视频异步任务,可在这里轮询。

Callback 协议

不想自己轮询时,优先把结果推回你的服务端。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json

请求体沿用官方 Kling 字段语义;其中 model_name 仍然是官方模型名,不是 DeerAPI live capability ID。

image
string
default:example
required

参考图像,必须,支持Base64编码或图片URL,支持.jpg / .jpeg / .png格式,大小不能超过10MB,分辨率不小于300*300px

prompt
string

正向文本提示, 可选,不能超过500个字符

negative_prompt
string

负向文本提示,可选,不能超过200个字符

callback_url
string

本次任务结果回调通知地址,可选

mode
string

生成视频的模式,可选,枚举值:std(高性能)或 pro(高表现)

model_name
string

Default value: kling-v1,Example values:kling-v1,kling-v1-5,kling-v1-6,kling-v2-master

image_tail
string

参考图像 - 尾帧控制,可选,支持Base64编码或图片URL,支持.jpg / .jpeg / .png格式,大小不能超过10MB,分辨率不小于300*300px

cfg_scale
number

生成视频的自由度,可选,值越大相关性越强,取值范围:[0, 1]

duration
string

生成视频时长,单位秒,可选,枚举值:5,10(包含尾帧的请求仅支持5秒)

static_mask
string

静态画笔应用区域(用户使用动态画笔应用的遮罩图像)

dynamic_masks
object

动态刷配置列表 可配置多个组(最多 6 个),每个组包含一系列 “涂抹区域遮罩 ”和 “运动轨迹”。

external_task_id
string

自定义任务 ID 用户自定义的任务 ID,传入后不会覆盖系统生成的任务 ID,但支持通过此 ID 查询任务 请注意,在单用户情况下需要保证唯一性。

Response

200 - application/json

任务已受理,返回 task_id。后续请通过查询接口或 callback 获取最终视频结果。

code
integer
required

错误码;具体定义错误码

message
string
required

错误信息

request_id
string
required

请求ID,系统生成,用于跟踪请求、排查问题

data
object
required