# 对口型

## 人脸识别

POST `/v1/videos/identify-face`

cURL

```bash
curl --request POST \
  --url https://api-beijing.klingai.com/v1/videos/identify-face \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "video_url": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/kling20260206mp4.mp4",
    "video_id": ""
  }'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "session_id": "id", // 会话ID
    "final_unit_deduction": "string", // 任务最终扣减积分数值
    "face_data": [ //人脸数据列表
      {
        "face_id": "string", // 人脸ID
        "face_image": "url", // 人脸图片URL
        "start_time": 0, // 人脸出现开始时间，单位ms
        "end_time": 5200 //人脸出现结束时间，单位ms
      }
    ]
  }
}
```

识别视频中的人脸以进行对口型处理。

### 请求头

- Content-Type string必填 默认值 application/json

- Authorization string必填

### 请求体

- video_id string 可选

- video_url string 可选

---

## 创建任务

POST `/v1/videos/advanced-lip-sync`

cURL

```bash
curl --request POST \
  --url https://api-beijing.klingai.com/v1/videos/advanced-lip-sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "session_id": "850508686686064678",
    "face_choose": [
      {
        "face_id": "0",
        "sound_file": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/go-to-world.mp3",
        "sound_insert_time": 1000,
        "sound_start_time": 0,
        "sound_end_time": 3000,
        "sound_volume": 2,
        "original_audio_volume": 2
      }
    ],
    "external_task_id": "",
    "callback_url": ""
  }'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_info": { // 任务创建时的参数信息
      "external_task_id": "string" // 客户自定义任务ID
    },
    "task_status": "string", // 任务状态
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
  }
}
```

### 请求头

- Content-Type string 必填 默认值 application/json

- Authorization string 必填

### 请求体

- session_id string 必填

- face_choose array 必填

---

## 查询任务（单个）

GET `/v1/videos/advanced-lip-sync/{id}`

cURL

```bash
curl --request GET \
  --url https://api-beijing.klingai.com/v1/videos/advanced-lip-sync/{task_id} \
  --header 'Authorization: Bearer <token>'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_status": "string", // 任务状态
    "task_status_msg": "string", // 任务状态信息
    "task_info": { // 任务创建时的参数信息
      "parent_video": { // 原始视频信息
        "id": "string", // 原始视频ID
        "url": "string", // 原始视频URL
        "duration": "string" // 原始视频时长，单位s
      }
    },
    "task_result": { // 任务结果
      "videos": [ // 生成的视频列表
        {
          "id": "string", // 生成的视频 ID
          "url": "string", // 生成视频的 URL
          "watermark_url": "string", // 含水印视频下载URL
          "duration": "string" // 视频总时长，单位s
        }
      ]
    },
    "watermark_info": {
      "enabled": boolean // 是否启用水印
    },
    "final_unit_deduction": "string", // 任务最终扣减积分数值
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
  }
}
```

### 请求头

- Content-Type string 必填 默认值 application/json

- Authorization string 必填

### 路径参数

- task_id string 可选

---

## 查询任务（列表）

GET `/v1/videos/advanced-lip-sync`

cURL

```bash
curl --request GET \
  --url 'https://api-beijing.klingai.com/v1/videos/advanced-lip-sync?pageNum=1&pageSize=30' \
  --header 'Authorization: Bearer <token>'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": [
    {
      "task_id": "string", // 任务 ID
      "task_status": "string", // 任务状态
      "task_status_msg": "string", // 任务状态信息
      "task_info": { // 任务创建时的参数信息
        "parent_video": { // 原始视频信息
          "id": "string", // 原始视频 ID
          "url": "string", // 原始视频 URL
          "duration": "string" // 原始视频时长，单位s
        }
      },
      "task_result": { // 任务结果
        "videos": [ // 生成的视频列表
          {
            "id": "string", // 生成的视频 ID
            "url": "string", // 生成视频的 URL
            "watermark_url": "string", // 含水印视频下载URL
            "duration": "string" // 视频总时长，单位s
          }
        ]
      },
      "watermark_info": {
        "enabled": boolean // 是否启用水印
      },
      "final_unit_deduction": "string", // 任务最终扣减积分数值
      "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
      "updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
    }
  ]
}
```

### 请求头

- Content-Type string 必填 默认值 application/json

- Authorization string 必填

### 查询参数

- pageNum int 可选 默认值 1

- pageSize int 可选 默认值 30

---

可灵视频3.0系列模型再次迎来升级，支持一键生成原生4K视频，轻松解锁大屏高清终端展示、专业商业交付等核心商用场景，助力企业提升内容竞争力。

**亮点与应用场景：**

1. **行业级画质，直达商用标准：** 4K画质细节精准还原，直达商用交付/送审标准，无超分损耗，色彩与清晰度均符合行业规范
2. **一键原生4K，高效省成本：** 跳过传统超分环节，毫秒级响应生成，无需专业技术操作，大幅提升商业创作效率、降低时间成本
3. **普惠商用场景：** 顶级4K画质，价格极具竞争力，无需额外投入昂贵第三方工具，轻松实现高质量视频制作

**原生4K·一键直出，赋能广告、影视等商业创作！**

🔗 [点击即刻接入](/content/document-api/apiReference/updateNotice/index.html)