Skip to main content
GET
/
kling
/
v1
/
videos
/
omni-video
/
{task_id}
cURL
curl --request GET \
+  --url https://api.deerapi.com/kling/v1/videos/omni-video/task_xxx \
+  --header 'Authorization: Bearer <DEERAPI_KEY>'
{
  "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>"
        }
      ]
    }
  }
}
GET /kling/v1/videos/omni-video/{task_id} 只给 Omni 视频 创建出的任务使用。它不是通用 Kling 查询接口。
如果你在创建阶段已经配置了回调,这页通常用于补查状态、重新拉结果,或做运营后台对账。

先判断是不是这页

  • 上游任务来自 Omni 视频:用这页。
  • 上游任务来自文生视频、图生视频、多图视频等通用路由:改看 查询任务
  • 你手里只有 external_task_id:先回业务库把它映射回真正的 task_id,再调用查询接口。

轮询时看什么

  • 先看 task_status,区分 submitted、processing、succeed、failed。
  • 成功后再读取 task_result.videos 等结果字段。
  • 如果你的业务关注水印或附加元数据,也在这一阶段统一读取。

常见误解

  • 把非 Omni 任务丢到这条专用查询接口。
  • 以为查询阶段还要再传 model_nameprompt
  • external_task_id 直接替代路径里的 task_id

相关页面

Omni 视频

创建 Omni 多模态视频任务的上游入口。

查询任务

其他 Kling 视频与图像任务仍走通用查询页。

Callback 协议

如果你不想自己轮询,可以在创建阶段直接配置回调。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Path Parameters

task_id
string
required

任务ID

Response

200 - application/json

查询成功,返回当前任务状态、任务结果和可选的 watermark 信息。

code
integer
required

返回码

message
string
required

对请求结果的文字描述

request_id
string
required

本次请求的唯一标识符

data
object
required

包含具体响应数据的对象