跳转到主要内容
POST
/
kling
/
v1
/
videos
/
image2video
创建图生视频任务
curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v2-master",
  "image": "<string>",
  "image_tail": "<string>",
  "prompt": "<string>",
  "negative_prompt": "<string>",
  "mode": "std",
  "duration": "5",
  "cfg_scale": 0.5,
  "multi_shot": false,
  "shot_type": "customize",
  "multi_prompt": [
    {
      "index": 123,
      "prompt": "<string>",
      "duration": "<string>"
    }
  ],
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "sound": "off",
  "camera_control": {
    "type": "simple",
    "config": {
      "horizontal": 123,
      "vertical": 123,
      "pan": 123,
      "tilt": 123,
      "roll": 123,
      "zoom": 123
    }
  },
  "static_mask": "<string>",
  "dynamic_masks": [
    {
      "mask": "<string>",
      "trajectories": [
        {
          "x": 123,
          "y": 123
        }
      ]
    }
  ],
  "watermark_info": {
    "enabled": true
  },
  "callback_url": "<string>",
  "external_task_id": "<string>"
}
'
{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v2-master",
  "status": "<string>",
  "progress": 0,
  "created_at": 1773130665
}

授权

Authorization
string
header
必填

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

请求体

application/json
model_name
enum<string>

模型名称

可用选项:
kling-v2-master
示例:

"kling-v2-master"

image
string

参考图片(首帧)。Base64 或 URL。格式:.jpg/.jpeg/.png,≤10MB,最小 300px。

image_tail
string

参考图片(尾帧)。image 和 image_tail 至少填一个。

prompt
string

正向提示词。multi_shot 为 false 时必填。

Maximum string length: 2500
negative_prompt
string

负向提示词。

Maximum string length: 2500
mode
enum<string>
默认值:std

std:标准模式。pro:专业模式(画质更好)。

可用选项:
std,
pro
duration
enum<string>
默认值:5

视频时长(秒),3-15。

可用选项:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
cfg_scale
number
默认值:0.5

提示词相关性(0-1),值越高越贴合。

必填范围: 0 <= x <= 1
multi_shot
boolean
默认值:false

是否启用多镜头分镜。

shot_type
enum<string>

分镜方式。

可用选项:
customize,
intelligence
multi_prompt
object[]

分镜信息(1-6 个镜头)。

element_list
object[]

参考元素(最多 3 个)。

sound
enum<string>
默认值:off

是否生成音效。仅 V2.6+。

可用选项:
on,
off
camera_control
object

运镜控制。

static_mask
string

静态笔刷蒙版(Base64 或 URL)。

dynamic_masks
object[]

动态笔刷配置(最多 6 组)。

watermark_info
object
callback_url
string
external_task_id
string

响应

任务创建成功

id
string
示例:

"860260753860210752"

task_id
string
示例:

"860260753860210752"

object
string
示例:

"video"

model
string
示例:

"kling-v2-master"

status
string
progress
integer
示例:

0

created_at
integer
示例:

1773130665