Kling
文生视频
DeerAPI 文生视频接入说明：通过统一网关调用 Kling text2video，明确区分 DeerAPI capability ID 与请求体 model_name，并说明查询与回调方式。
POST
/
kling
/
v1
/
videos
/
text2video
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/text2video \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v2-6",
"prompt": "夜色中的城市天桥上，一只机械鹿缓慢回头，镜头轻推。",
"duration": "5",
"mode": "pro",
"aspect_ratio": "16:9",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"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/text2video 适合从零起稿生成视频。你只有文字描述，还没有首帧、尾帧或多张参考图时，先用这页。
DeerAPI 模型列表里看到的
kling_video 是平台能力名；真正决定 Kling 代际和特性的，仍然是请求体里的 model_name。什么时候该用它
- 你要先验证创意方向，再决定是否补参考图、音频或更复杂控制。
- 你希望从纯文本起步，而不是锁定某张现成图片。
- 官方 3.0 系列强调更长时长、分镜和更强文本保持；是否可用取决于当前
model_name和你的账户能力。
最小可用调用
- 首个请求先保留
prompt，让链路和画面方向先跑通。 - 需要固定画面比例时再补
aspect_ratio。 - 想缩短试错周期时，先选较短
duration。 - 需要固定具体模型版本时，再显式传
model_name。 - 不想轮询时，在创建阶段直接带
callback_url。
不要把这页用成什么
常见误解
- 把
kling_video当成model_name传入。 - 第一次调用就把负向提示、镜头控制、回调和业务主键全部塞进请求，导致排障成本变高。
- 只记录
request_id，没有保存task_id。
相关页面
图生视频
已有首帧或尾帧时，优先改走这条路由。
多图参考生视频
需要靠多张主体图锁定一致性时使用。
查询任务
文生视频提交后，可在这里轮询通用 Kling 任务状态。
Callback 协议
想让结果主动回推到你的服务端时看这页。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Headers
Body
application/json
请求体沿用官方 Kling 字段语义；其中 model_name 是官方模型枚举，不是 DeerAPI live capability ID。
正向文本提示词, 不能超过2500个字符
负向文本提示，可选，不能超过2500个字符
生成视频的画面纵横比，可选，枚举值：16:9, 9:16, 1:1
本次任务结果回调通知地址，可选
模型名称, 枚举值：kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6
生成视频的自由度，可选，值越大，相关性越强，取值范围：[0,1]
生成视频的模式，可选，枚举值：std（高性能）或 pro（高表现）
Available options:
std, pro 生成视频时长，单位秒，可选，枚举值：5，10
控制摄像机运动的协议，可选，未指定则智能匹配
Show child attributes
Show child attributes
自定义任务 ID 用户自定义的任务 ID，传入后不会覆盖系统生成的任务 ID，但支持通过此 ID 查询任务 请注意，在单用户情况下需要保证唯一性。
⌘I
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/text2video \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v2-6",
"prompt": "夜色中的城市天桥上，一只机械鹿缓慢回头，镜头轻推。",
"duration": "5",
"mode": "pro",
"aspect_ratio": "16:9",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"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
}
}