Kling 3.0 Omni

通过 POST /kling/v1/videos/omni-video 并设置 model_name: "kling-3.0-omni" 调用。文本、图片、视频和主体参考属于同一模型的不同能力。

Omni 视频生成

创建任务

POST /kling/v1/videos/omni-video使用 model_name: "kling-3.0-omni"，结合提示词、图片、视频和主体完成视频生成或编辑。

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/omni-video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-3.0-omni",
    "prompt": "<<<image_1>>> 中的角色走进雨中的霓虹街道",
    "image_list": [
      {"image_url": "https://example.com/character.png"}
    ],
    "duration": "5",
    "mode": "pro",
    "aspect_ratio": "16:9"
  }'

请求头

string

必填

Bearer 身份验证，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求数据格式，固定为 application/json。

请求参数

string

必填

固定为 kling-3.0-omni。

string

最长 2500 字符；用 <<<image_1>>>、<<<video_1>>>、<<<element_1>>> 引用素材。

object[]

参考图片、首帧或尾帧列表。

参考视频列表，最多 1 个；每项包含 video_url、refer_type 和 keep_original_sound。

object[]

主体列表；数量受是否传入参考视频影响。

boolean

默认值:false

是否生成多镜头视频。

string

多镜头时填写 customize 或 intelligence。

object[]

1–6 个自定义分镜。

string

默认值:"pro"

std、pro 或 4k。

string

16:9、9:16 或 1:1；无首帧且非视频编辑时填写。

string

默认值:"5"

3–15 秒；refer_type: "base" 时不生效。

string

默认值:"off"

生成音效；存在 video_list 时必须为 off。

object

通过 enabled 控制平台水印。

string

必填

参考图片 URL 或原始 Base64。

string

first_frame 或 end_frame；尾帧必须与首帧同时使用。

参考视频 URL。

base 为基于原视频编辑，feature 为特征参考。

是否保留原视频声音，可选 yes 或 no。

integer

必填

主体管理接口返回的主体 ID。

integer

必填

分镜序号，从 1 开始。

string

必填

当前分镜提示词，最长 512 字符。

string

必填

当前分镜时长，至少 1 秒。

boolean

默认值:false

是否添加平台水印。

创建响应

200

{"id":"860260753860210752","task_id":"860260753860210752","object":"video","model":"kling-v3-omni","status":"queued","progress":0,"created_at":1773130665}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

固定为 video。

string

kling-v3-omni。

string

初始任务状态。

integer

初始进度。

integer

创建 Unix 时间戳。

图片与主体

图片支持 URL 或不带 data URI 前缀的原始 Base64；格式为 JPG、JPEG、PNG，单张不超过 10 MB，宽高均不小于 300 px，宽高比为 1:2.5 至 2.5:1。
image_list[].type 可设为 first_frame 或 end_frame；尾帧必须与首帧同时使用。
无参考视频时，图片与多图主体合计最多 7 个，视频角色主体最多 3 个。
有参考视频时，图片与多图主体合计最多 4 个，视频角色主体最多 1 个。

参考视频

参考视频支持 MP4、MOV，时长 3–15.5 秒，大小不超过 200 MB，帧率 24–60 fps，宽高 700–4553 px，总像素不超过 8,294,400，宽高比为 1:2.5 至 2.5:1。

`refer_type`	行为与限制
`base`	基于原视频编辑；沿用原视频时长，顶层 `duration` 不生效；不支持多镜头和首尾帧控制
`feature`	参考原视频内容、动作、风格或运镜；可使用智能多镜头

video_list[].keep_original_sound 控制是否保留原视频声音。只要存在 video_list，就不能通过 sound 生成新音效。

查询任务（单个）

GET /kling/v1/videos/omni-video/{task_id}

请求头

string

必填

Bearer 身份验证，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，固定为 application/json。

路径参数

string

必填

创建 Omni 视频任务时返回的任务 ID。

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/omni-video/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

查询响应

200

{
  "code": 0,
  "data": {
    "created_at": 1784516360000,
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_result": {
      "videos": [{
        "duration": "5",
        "url": "https://example.com/generated-video.mp4"
      }]
    },
    "task_status": "succeed",
    "updated_at": 1784516573000
  },
  "message": ""
}

响应字段

integer

0 表示查询请求已成功处理。

string

错误信息；查询成功时为空字符串。

string

当前查询的任务 ID。

string

任务状态：submitted、processing、succeed 或 failed。

string

任务失败时返回的具体原因。

object[]

任务成功后返回的生成视频列表。

string

生成视频的临时访问地址。

string

实际生成的视频时长，单位为秒。

integer

任务创建时间，Unix 毫秒时间戳。

integer

任务最后更新时间，Unix 毫秒时间戳。

AnyFast 在可灵旧版接口前增加 /kling 路由前缀。创建和任务查询仍按能力使用对应路径。

概览

原生兼容端点

模型 API

创建任务

请求头

请求参数

创建响应

图片与主体

参考视频

查询任务（单个）

请求头

路径参数

查询响应

响应字段

​创建任务

​请求头

​请求参数

​创建响应

​图片与主体

​参考视频

​查询任务（单个）

​请求头

​路径参数

​查询响应

​响应字段

创建任务

请求头

请求参数

创建响应

图片与主体

参考视频

查询任务（单个）

请求头

路径参数

查询响应

响应字段