# 图生视频

**方法**: `POST`
**路径**: `/kling/v1/videos/image2video`

本文档不实时更新，完整版请查看官方文档：<https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M>

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
model_name
string
可选
kling-v1、kling-v1-5、kling-v1-6
image
string
必需
参考图像，必须，支持Base64编码或图片URL，支持.jpg / .jpeg / .png格式，大小不能超过10MB，分辨率不小于300*300px
image_tail
string
可选
参考图像 - 尾帧控制，可选，支持Base64编码或图片URL，支持.jpg / .jpeg / .png格式，大小不能超过10MB，分辨率不小于300*300px
prompt
string
可选
正向文本提示， 可选，不能超过500个字符
<= 5000 字符
negative_prompt
string
可选
负向文本提示，可选，不能超过200个字符
<= 2000 字符
cfg_scale
number
可选
生成视频的自由度，可选，值越大相关性越强，取值范围：[0, 1]
>= 0
<= 1
mode
enum<string>
可选
生成视频的模式，可选，枚举值：std（高性能）或 pro（高表现）
枚举值:
std（高性能）
pro（高表现）
duration
enum<string>
可选
生成视频时长，单位秒，可选，枚举值：5，10（包含尾帧的请求仅支持5秒）
枚举值:
5
10
callback_url
string
可选
本次任务结果回调通知地址，可选
示例
{
"model_name"
:
"string"
,
"image"
:
"string"
,
"image_tail"
:
"string"
,
"prompt"
:
"string"
,
"negative_prompt"
:
"string"
,
"cfg_scale"
:
0
,
"mode"
:
"std（高性能）"
,
"duration"
:
"5"
,
"callback_url"
:
"string"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/videos/image2video' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "string",
    "image": "string",
    "image_tail": "string",
    "prompt": "string",
    "negative_prompt": "string",
    "cfg_scale": 0,
    "mode": "std（高性能）",
    "duration": "5",
    "callback_url": "string"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

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

#### 示例

```json
{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}
```