跳转到主要内容
POST
/
v1
/
image_to_video
创建图生视频任务
curl --request POST \
  --url https://api.keevx.cn/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "KL",
  "prompt": "一只金毛犬在草地上奔跑，阳光明媚，电影级光影",
  "aspect_ratio": "16:9",
  "aspect_resolution": "1080p",
  "duration": 5,
  "reference_images": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "generate_count": 1,
  "callback_url": "https://your-server.com/callback"
}
'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "task_ids": [
      "i2v-d6b6472bcf724d0399e06d1390cb964e",
      "i2v-fc654817587e435e937f1e1b80366c00"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.keevx.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
模型参数详细规则

根据 model 的值，各参数的必填状态和有效范围如下：
名称：标准模型-多参考图生视频特性：强制使用多参考图输入。
参数是否必填说明
prompt是图生视频提示词。
reference_images是必须提供参考图列表。（最多 7 张图片）
aspect_resolution是支持 720p、1080p。
duration是支持 5、10 秒。
image_url否不支持。

​
回调通知

视频生成任务处理完成后，服务将向发起请求中提供的 callback_url 发送一个 POST 请求。

​
结构

​
code
integer
响应状态码。0 表示回调发送成功。
​
msg
string
响应消息，通常为 “ok”。
​
task_type
string
任务类型。枚举值：image_to_video。
​
data
object
包含生成结果的数据载体。

​
回调示例

{
    "code": 0,
    "msg": "ok",
    "task_type": "image_to_video",
    "data": {
        "task_id": "i2v-d6b6472bcf724d0399e06d1390cb964e",
        "status": "SUCCEEDED",
        "video_url": "https://xiling-dh.bj.bcebos.com/tmp/image2video/kling/951742d2-bea1-4ccf-acfa-73cb7b073ae8/i2v-82b660e5aea44414a2a7b10c12b6bcbd/6544fe9d-0b2e-423e-9b2f-33303ff48c04.mp4",
        "thumbnail_url": "https://xiling-dh.cdn.bcebos.com/media/image2video/converted/93c9943d-3323-42ee-b7cc-6915517ec4dd_converted.jpg",
        "error_message": ""
    }
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

创建图生视频任务，使用 KL 模型。

​
model
enum<string>
必填

模型标识符。

  • KL：多参考图模式。
可用选项:
KL
示例:

"KL"

​
prompt
string
必填

视频生成提示词，限制 1000 字符。

示例:

"一只金毛犬在草地上奔跑，阳光明媚，电影级光影"

​
aspect_ratio
enum<string>
必填

视频宽高比。

可用选项:
16:9,
9:16
示例:

"16:9"

​
aspect_resolution
enum<string>
必填

视频分辨率。支持 720p、1080p。

可用选项:
720p,
1080p
示例:

"1080p"

​
duration
enum<integer>
必填

视频时长（秒）。支持 5 或 10。

可用选项:
5,
10
示例:

5

​
reference_images
string<uri>[]

参考图片 URL 列表（必填）。每张图片最大 20MB。

Maximum array length: 5
示例:
[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.jpg"
]
​
generate_count
integer
默认值:1

生成视频数量（1-4）。

必填范围: 1 <= x <= 4
示例:

1

​
callback_url
string<uri>

任务完成回调通知 URL。

示例:

"https://your-server.com/callback"

响应

任务创建成功

任务创建响应

​
code
integer
必填

状态码（0 表示成功）

示例:

0

​
msg
string
必填

响应消息

示例:

"ok"

​
data
object
必填

包含生成的任务 ID 的数据