# Omni-Video

## 创建任务

POST`/v1/videos/omni-video`

cURL

```bash
curl --request POST \
  --url https://api-beijing.klingai.com/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model_name": "kling-video-o1",
  "prompt": "让<<<image_1>>>中的人物向镜头挥手",
  "image_list": [ \
    { \
      "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png" \
    } \
  ],
  "duration": "5",
  "mode": "pro",
  "aspect_ratio": "16:9",
  "callback_url": "",
  "external_task_id": ""
}'
```

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", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}
```

Omni 模型可以通过 Prompt 结合元素、图片、视频等内容实现多种能力。

### 请求头

Content-Typestring必填默认值 application/json

数据交换格式

Authorizationstring必填

鉴权信息，参考接口鉴权

### 请求体

model_namestring可选默认值 kling-video-o1

模型名称

枚举值：kling-video-o1kling-v3-omni

multi_shotboolean可选默认值 false

是否生成多镜头视频。

当前参数为 true 时，prompt 参数无效，且不支持设定首尾帧生视频。当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。

shot_typestring可选

分镜方式。

枚举值：customizeintelligence

当 multi_shot 参数为 `true` 时，当前参数必填。

promptstring可选

文本提示词，可包含正向描述和负向描述。

- 可将提示词模板化来满足不同的视频生成需求
- 不能超过 2,500 个字符

当 "multi_shot 为 `false` "或" multi_shot参数为`true`且shot-type参数为`intelligence`"时，当前参数不得为空

Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力：

- 通过<<<>>>的格式来指定某个主体、图片或视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>
- 能力范围详见使用手册： [可灵Omni模型使用指南](/content/document-api/external-link-confirm?url=https%3A%2F%2Fdocs.qingque.cn%2Fd%2Fhome%2FeZQCg5xHvxDaE-jP2GcnaNc6O%3FidentityId%3D2Cn18n4EIHT/index.html)、 [可灵视频 3.0 Omni 使用指南](/content/document-api/external-link-confirm?url=https%3A%2F%2Fdocs.qingque.cn%2Fd%2Fhome%2FeZQDPQ5RCKYKpTbz1poE88YSp%3FidentityId%3D2Cn18n4EIHT/index.html)

不同模型版本、视频模式支持范围不同，详见 [能力地图](/content/document-api/apiReference/model/videoModels/index.html)

### 请求范例

```bash
curl --location 'https://api-beijing.klingai.com/v1/videos/omni-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-video-o1",
    "prompt": "让<<<image_1>>>中的人物向镜头挥手",
    "image_list": [ \
        { \
         "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png" \
        }
    ],
    "duration": "5",
    "mode": "pro",
    "aspect_ratio": "16:9"
}'
```

## FAQ

**1、生成视频时长（duration）什么情况支持、什么情况不支持？**

- 文生，图生（不含首尾帧）：可选3~10s
- 有视频输入（video_list不为空）且 使用视频编辑功能（类型=base）时：不可指定时长，跟视频对齐
- 其他情况（不传视频+传图片+主体进行生视频，或者 传视频+视频类型=feature时），可选3-10s

**2、怎么进行视频延长？**

- 可以通过"视频参考"来实现，传入一段视频，通过prompt驱动模型"生成下一个镜头"或者"生成上一个镜头"

**3、生成视频宽高比（aspect_ratio）什么情况支持、什么情况不支持？**

- 不支持：指令变换（视频编辑），图生视频（包括首尾帧）
- 支持：文生视频，图片/主体参考，视频参考-其他，视频参考-生成下一个/上一个镜头