主题模式

可灵（Kling）API 总览 ​

官方文档入口（仅参考）：

统一请求头 ​

字段值描述
Content-Typeapplication/json数据交换格式
AuthorizationBearer鉴权信息

核心说明 ​

  1. 当前统一采用 /v1/videos/kling/... 接口路径承载可灵视频能力。

视频能力接口 ​

1) 文生视频（Text2Video） ​

功能方法路径
创建POST/v1/videos/kling/text2video
单任务查询GET/v1/videos/kling/text2video/{task_id}
列表查询GET/v1/videos/kling/text2video?pageNum=1&pageSize=30

2) 图生视频（Image2Video） ​

功能方法路径
创建POST/v1/videos/kling/image2video
单任务查询GET/v1/videos/kling/image2video/{task_id}
列表查询GET/v1/videos/kling/image2video?pageNum=1&pageSize=30

3) 动作控制（Motion Control） ​

功能方法路径
创建POST/v1/videos/kling/motion-control
单任务查询GET/v1/videos/kling/motion-control/{task_id}
列表查询GET/v1/videos/kling/motion-control?pageNum=1&pageSize=30

说明：

  • 动作控制创建接口允许不传模型，默认使用 Kling-V2.6。

4) Omni / 多镜头（Omni Video） ​

功能方法路径
创建POST/v1/videos/kling/omni-video
单任务查询GET/v1/videos/kling/omni-video/{task_id}
列表查询GET/v1/videos/kling/omni-video?pageNum=1&pageSize=30

5) 多图参考生视频（Multi-Image2Video） ​

功能方法路径
创建POST/v1/videos/kling/multi-image2video
单任务查询GET/v1/videos/kling/multi-image2video/{task_id}
列表查询GET/v1/videos/kling/multi-image2video?pageNum=1&pageSize=30

6) 多模态视频编辑（Multi-Elements） ​

功能方法路径
初始化选区POST/v1/videos/kling/multi-elements/init-selection
增加选区POST/v1/videos/kling/multi-elements/add-selection
删除选区POST/v1/videos/kling/multi-elements/delete-selection
清除选区POST/v1/videos/kling/multi-elements/clear-selection
预览选区POST/v1/videos/kling/multi-elements/preview-selection
创建任务POST/v1/videos/kling/multi-elements
单任务查询GET/v1/videos/kling/multi-elements/{task_id}
列表查询GET/v1/videos/kling/multi-elements?pageNum=1&pageSize=30

主体能力接口 ​

能力方法路径
创建自定义主体POST/v1/elements/custom
查询自定义主体列表GET/v1/elements/custom
查询自定义主体单个GET/v1/elements/{id}
查询官方主体列表GET/v1/elements/presets
删除自定义主体POST/v1/elements/delete

查询参数 ​

列表查询通用参数：

参数名类型必填默认值说明
pageNumint否1页码，范围 [1, 1000]
pageSizeint否30每页条数，范围 [1, 500]
providerstring否-可选服务商

参数兼容 ​

  1. model 兼容：支持 model，会在对应接口归一化到 model_name 或内部标准模型。
  2. seconds 兼容：支持 seconds，会归一化为 duration。
  3. 多图字段兼容：image_list 中兼容 image / image_url / url / base64 等形式（以各子接口实现为准）。
  4. 历史字段兼容：动作控制中会清理 action_control 等内部/历史字段，不作为上游主参数。

关键约束 ​

  1. Kling-Video-O1、Kling-V3-Omni 请优先使用 /v1/videos/kling/omni-video。
  2. 若将 Omni 模型发到 text2video 或 image2video 路径，当前实现会按规则拒绝或返回上游校验错误（常见 422）。

返回结构（总览） ​

创建任务返回（示例） ​

json
{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "string",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": "string"
    },
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  },
  "aiping_id": "string"
}

单任务查询返回（示例） ​

json
{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "string",
    "task_status": "succeed",
    "task_status_msg": "string",
    "task_info": {
      "external_task_id": "string"
    },
    "task_result": {
      "videos": [
        {
          "id": "string",
          "url": "string",
          "watermark_url": "string",
          "duration": "string"
        }
      ]
    },
    "watermark_info": {
      "enabled": true
    },
    "final_unit_deduction": "string",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  },
  "aiping_id": "string"
}

列表查询返回（示例） ​

json
{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": [
    {
      "task_id": "string",
      "task_status": "succeed",
      "task_status_msg": "string",
      "task_info": {
        "external_task_id": "string"
      },
      "task_result": {
        "videos": [
          {
            "id": "string",
            "url": "string",
            "watermark_url": "string",
            "duration": "string"
          }
        ]
      },
      "watermark_info": {
        "enabled": true
      },
      "final_unit_deduction": "string",
      "created_at": 1722769557708,
      "updated_at": 1722769557708
    }
  ],
  "aiping_id": "string"
}