# 文生视频

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

本文档不实时更新，完整版请查看官方文档：<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
prompt
string
必需
正向文本提示，必须，不能超过500个字符
<= 500 字符
negative_prompt
string
可选
负向文本提示，可选，不能超过200个字符
<= 200 字符
cfg_scale
number
可选
生成视频的自由度，可选，值越大，相关性越强，取值范围：[0,1]
>= 0
<= 1
mode
enum<string>
可选
生成视频的模式，可选，枚举值：std（高性能）或 pro（高表现）
枚举值:
std（高性能）
pro（高表现）
camera_control
object
可选
控制摄像机运动的协议，可选，未指定则智能匹配
type
string
可选
config
object
可选
包含六个字段，用于指定摄像机的运动或变化
aspect_ratio
enum<string>
可选
生成视频的画面纵横比，可选，枚举值：16:9, 9:16, 1:1
枚举值:
16:9
9:16
1:1
duration
enum<string>
可选
生成视频时长，单位秒，可选，枚举值：5，10
枚举值:
5
10
callback_url
string
可选
本次任务结果回调通知地址，可选
示例
{
"model_name"
:
"string"
,
"prompt"
:
"string"
,
"negative_prompt"
:
"string"
,
"cfg_scale"
:
0
,
"mode"
:
"std（高性能）"
,
"camera_control"
:
{
"type"
:
"string"
,
"config"
:
{
"horizontal"
:
-10
,
"vertical"
:
-10
,
"pan"
:
-10
,
"tilt"
:
-10
,
"roll"
:
-10
,
"zoom"
:
-10
}
}
,
"aspect_ratio"
:
"16:9"
,
"duration"
:
"5"
,
"callback_url"
:
"string"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/videos/text2video' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "string",
    "prompt": "string",
    "negative_prompt": "string",
    "cfg_scale": 0,
    "mode": "std（高性能）",
    "camera_control": {
        "type": "string",
        "config": {
            "horizontal": -10,
            "vertical": -10,
            "pan": -10,
            "tilt": -10,
            "roll": -10,
            "zoom": -10
        }
    },
    "aspect_ratio": "16:9",
    "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
    }
}
```