Kling
任务查询
DeerAPI Kling 通用查询入口：通过 GET /kling/v1/// 复用常见异步任务的单任务查询逻辑。
GET
/
kling
/
v1
/
{action}
/
{action2}
/
{task_id}
cURL
Copy
curl --request GET \
+ --url https://api.deerapi.com/kling/v1/videos/text2video/task_xxx \
+ --header 'Authorization: Bearer <DEERAPI_KEY>'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123,
"task_info": {
"parent_video": {
"id": "<string>",
"url": "<string>",
"duration": "<string>"
}
},
"task_result": {
"videos": [
{
"id": "<string>",
"url": "<string>",
"duration": "<string>"
}
]
}
}
}把当前页理解成“通用轮询入口”，不是“任何 Kling 能力都必须走它”。
先判断能不能用当前页
| 任务类型 | 是否适合 | 说明 |
|---|---|---|
videos/text2video、videos/image2video、videos/multi-image2video、videos/effects、audio/text-to-audio、audio/video-to-audio、images/generations、images/kolors-virtual-try-on | 适合 | 两段路径任务优先先用当前页 |
videos/avatar/image2video、images/editing/expand、videos/multi-elements/* | 不建议 | 这些能力更适合沿用各自页面定义的查询或 workflow |
推荐的接入方式
需要事件驱动时改用 callback
如果你的系统更适合被动接收结果，而不是主动轮询，直接改用 Callback 协议。
查询结果里先看哪几个字段
task_status：任务当前阶段，决定你是不是该继续轮询。task_status_msg：失败或异常时先看这里。task_result：真正的成品字段。图像、视频、音频三类任务的形状不同。task_info.external_task_id：如果你创建时自己带了业务键，回查时可以用它和内部订单做关联。
action 和 action2 是路由片段，不是 DeerAPI capability ID，也不是请求体里的 model_name。相关页面
Callback 协议
当你不想持续轮询时，用这一页改成回调模式。
Omni 专用查询
Omni Video 单独有一页，适合把 omni 工作流与通用查询拆开管理。
Kling 官方文生视频
当你要核对 text2video 上游字段时看这里。
Kling 官方图生视频
当你要核对 image2video 上游字段时看这里。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Path Parameters
能力一级路径。常见取值为 images、videos、audio。
能力二级路径。常见组合包括 generations、text2video、image2video、multi-image2video、video-extend、effects、advanced-lip-sync、omni-video、text-to-audio、video-to-audio、tts、kolors-virtual-try-on。
任务ID
⌘I
cURL
Copy
curl --request GET \
+ --url https://api.deerapi.com/kling/v1/videos/text2video/task_xxx \
+ --header 'Authorization: Bearer <DEERAPI_KEY>'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123,
"task_info": {
"parent_video": {
"id": "<string>",
"url": "<string>",
"duration": "<string>"
}
},
"task_result": {
"videos": [
{
"id": "<string>",
"url": "<string>",
"duration": "<string>"
}
]
}
}
}