跳转到主要内容
POST
/
kling
/
v1
/
videos
/
text2video
创建文生视频任务
curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "一只猫在金色夕阳下穿过向日葵花田",
  "model_name": "kling-v1-6",
  "negative_prompt": "<string>",
  "mode": "std",
  "duration": "5",
  "aspect_ratio": "16:9",
  "cfg_scale": 0.5,
  "multi_shot": false,
  "shot_type": "customize",
  "multi_prompt": [
    {
      "index": 123,
      "prompt": "<string>",
      "duration": "<string>"
    }
  ],
  "sound": "off",
  "camera_control": {
    "type": "simple",
    "config": {
      "horizontal": 123,
      "vertical": 123,
      "pan": 123,
      "tilt": 123,
      "roll": 123,
      "zoom": 123
    }
  },
  "watermark_info": {
    "enabled": true
  },
  "callback_url": "<string>",
  "external_task_id": "<string>"
}
'
{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v1-6",
  "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
prompt
string
必填

正向文本提示词,最长 2500 字符。

Maximum string length: 2500
示例:

"一只猫在金色夕阳下穿过向日葵花田"

model_name
enum<string>

模型名称

可用选项:
kling-v1-6
示例:

"kling-v1-6"

negative_prompt
string

负向文本提示词,最长 2500 字符。

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
示例:

"5"

aspect_ratio
enum<string>
默认值:16:9

生成视频的画面比例(宽:高)。

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

"16:9"

cfg_scale
number
默认值:0.5

提示词相关性(0-1),值越大模型自由度越小。kling-v2.x 模型不支持此参数。

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

是否生成多镜头视频。为 true 时 prompt 无效,需使用 multi_prompt。

shot_type
enum<string>

分镜方式。multi_shot 为 true 时必填。

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

分镜信息(1-6 个)。multi_shot 为 true 且 shot_type 为 customize 时必填。

sound
enum<string>
默认值:off

是否同步生成音效。仅 V2.6 及以上版本支持。

可用选项:
on,
off
camera_control
object

运镜控制参数。

watermark_info
object
callback_url
string

任务状态回调通知 URL

external_task_id
string

自定义任务 ID,同一账号下须唯一。

响应

任务已创建

id
string
示例:

"860260753860210752"

task_id
string
示例:

"860260753860210752"

object
string
示例:

"video"

model
string
示例:

"kling-v1-6"

status
string
progress
integer
示例:

0

created_at
integer
示例:

1773130665