🎉 可灵AI 原生4K直出，现已开放API！支持V3系列模型 🎉

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

🌟 亮点与应用场景：

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

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

### 虚拟试穿

## 创建任务

POST`/v1/images/kolors-virtual-try-on`

```bash
curl --request POST \
  --url https://api-beijing.klingai.com/v1/images/kolors-virtual-try-on \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kolors-virtual-try-on-v1-5",
    "human_image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/tryon-human.webp",
    "cloth_image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/suite.webp",
    "callback_url": "",
    "external_task_id": ""
  }'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
  }
}
```

### 请求头

Content-Typestring必填默认值 application/json

数据交换格式

Authorizationstring必填

鉴权信息，参考接口鉴权

### 请求体

model_namestring可选默认值 kolors-virtual-try-on-v1

模型名称

枚举值：kolors-virtual-try-on-v1kolors-virtual-try-on-v1-5

human_imagestring必填

上传的人物图片

- 支持传入图片 Base64 编码或图片 URL（确保可访问）
- 注意：请确保您传递的所有图像数据参数均采用Base64编码格式。若您使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 `data:image/png;base64,`），直接传递 Base64 编码后的字符串即可。

- 正确的 Base64 编码参数：

```plaintext
iVBORw0KGgoAAAANSUhEUgAAAAUA...
```

- 错误的 Base64 编码参数（包含 data: 前缀）：

```plaintext
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...
```

- 图片格式支持 .jpg / .jpeg / .png
- 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px

cloth_imagestring必填

虚拟试穿的服饰图片

- 支持上传服饰商品图或服饰白底图，支持上装 upper、下装 lower、与连体装 dress
- 支持传入图片 Base64 编码或图片 URL（确保可访问）

Base64 编码说明：

请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。使用 Base64 时，请勿添加任何前缀如 `data:image/png;base64,`，只需提供 Base64 编码字符串本身。

正确示例：

```plaintext
iVBORw0KGgoAAAANSUhEUgAAAAUA...
```

错误示例：

```plaintext
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...
```

- 图片格式支持 .jpg / .jpeg / .png
- 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px

- 其中 kolors-virtual-try-on-v1-5 模型不仅支持单个服装输入，还支持"上装+下装"形式服装组合输入，即：
  - 输入单个服饰图片（上装 or 下装 or 连体装）→ 生成试穿的单品图片
  - 输入组合服饰图片（您可以将多个单品服饰白底图拼接到同一张图片）：
    - "上装+下装" → 成功
    - "上装+上装" → 失败
    - "下装+下装" → 失败
    - "连体装+连体装" → 失败
    - "上装+连体装" → 失败
    - "下装+连体装" → 失败

callback_urlstring可选

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知。

- 具体通知的消息schema见 [Callback协议](/content/document-api/apiReference/callbackProtocol/index.html)

external_task_idstring可选

自定义任务 ID

- 传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询

- 请注意，单用户下需要保证唯一性

## 查询任务（单个）

GET`/v1/images/kolors-virtual-try-on/{id}`

```bash
curl --request GET \
  --url https://api-beijing.klingai.com/v1/images/kolors-virtual-try-on/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "task_status_msg": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
    "final_unit_deduction": "string", // 任务最终扣减积分数值
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708, // 任务更新时间，Unix时间戳、单位ms
    "task_info": { // 任务创建时的参数信息
      "external_task_id": "string" // 客户自定义任务ID
    },
    "task_result": {
      "images": [
        {
          "index": 0, // 图片编号
          "url": "string" // 生成图片的URL，例如：https://h1.inkwai.com/...（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
        }
      ]
    }
  }
}
```

## 查询任务（列表）

GET`/v1/images/kolors-virtual-try-on`

```bash
curl --request GET \
  --url 'https://api-beijing.klingai.com/v1/images/kolors-virtual-try-on?pageNum=1&pageSize=30' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
```

200

```json
{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": [
    {
      "task_id": "string", // 任务ID，系统生成
      "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
      "task_status_msg": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
      "final_unit_deduction": "string", // 任务最终扣减积分数值
      "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
      "updated_at": 1722769557708, // 任务更新时间，Unix时间戳、单位ms
      "task_info": { // 任务创建时的参数信息
        "external_task_id": "string" // 客户自定义任务ID
      },
      "task_result": {
        "images": [
          {
            "index": 0, // 图片编号
            "url": "string" // 生成图片的URL（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
          }
        ]
      }
    }
  ]
}
```