kling-3.0-turbo

Kling 3.0 Turbo 使用可灵新版“模型即接口”结构。模型名称位于请求路径中，请求体不需要传入 model_name。

文生视频
图生视频
查询任务

创建任务

POST /kling/v2/text-to-video/kling-3.0-turbo

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v2/text-to-video/kling-3.0-turbo \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "一位女孩坐在火车上望向窗外，车厢轻轻摇晃",
    "settings": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "duration": 5
    },
    "options": {
      "watermark_info": {
        "enabled": false
      }
    }
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

文本提示词，可以包含正向和负向描述。最长 3072 个字符，建议控制在 2500 个字符以内。

object

输出清晰度、画面比例和时长配置。

string

默认值:"720p"

视频清晰度。枚举值：720p、1080p。

string

默认值:"16:9"

画面比例。枚举值：16:9、9:16、1:1。

integer

默认值:5

视频时长，单位为秒。支持 3 至 15 的整数。

object

通用生成配置。

object

平台水印配置。

boolean

默认值:false

设为 true 时同时生成含水印结果。

多镜头提示词格式

提示词可以使用 镜头 n, m, words; 格式定义 1 至 6 个镜头。n 为镜头序号，m 为镜头时长，words 为镜头描述。每个镜头至少持续 1 秒，全部镜头时长之和必须等于 settings.duration，每个镜头描述最长 512 个字符。

创建响应

200

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151,
    "external_id": ""
  }
}

integer

错误码，0 表示请求已受理。

string

错误或状态信息。

string

系统生成的请求 ID，用于链路跟踪和问题排查。

object

创建的异步任务。

string

系统生成的任务 ID。

string

任务状态：submitted、processing、succeeded 或 failed。

integer

任务创建时间，Unix 毫秒时间戳。

integer

任务更新时间，Unix 毫秒时间戳。

string

存在时返回自定义任务 ID。

创建任务

POST /kling/v2/image-to-video/kling-3.0-turbo

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v2/image-to-video/kling-3.0-turbo \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [
      {
        "type": "prompt",
        "text": "人物转头望向窗外，背景自然移动"
      },
      {
        "type": "first_frame",
        "url": "https://example.com/first-frame.png"
      }
    ],
    "settings": {
      "resolution": "1080p",
      "duration": 5
    },
    "options": {
      "watermark_info": {
        "enabled": false
      }
    }
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

object[]

必填

参考素材集合。在同一数组中传入提示词和首帧图。

string

必填

素材类型。枚举值：prompt、first_frame。

string

type 为 prompt 时必填。可以包含正向和负向描述，最长 2500 个字符。

string

type 为 first_frame 时必填。支持公开 URL 或 Base64 图片内容。

object

输出清晰度和时长配置。

string

默认值:"720p"

视频清晰度。枚举值：720p、1080p。

integer

默认值:5

视频时长，单位为秒。支持 3 至 15 的整数。

object

通用生成配置。

object

平台水印配置。

boolean

默认值:false

设为 true 时同时生成含水印结果。

首帧图要求

输入图片支持 JPG、JPEG 和 PNG，文件不能超过 50 MB。图片宽高均不能小于 300 px，宽高比须在 1:2.5 至 2.5:1 之间。Kling 3.0 Turbo 仅支持首帧图，不支持尾帧图或首尾帧组合输入。

多镜头提示词格式

prompt 素材可以使用 镜头 n, m, words; 格式定义 1 至 6 个镜头。每个镜头至少持续 1 秒，全部时长之和必须等于 settings.duration，每个镜头描述最长 512 个字符。

创建响应

200

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151,
    "external_id": ""
  }
}

integer

错误码，0 表示请求已受理。

string

错误或状态信息。

string

系统生成的请求 ID。

object

已创建的异步任务。

string

系统生成的任务 ID。

string

任务状态：submitted、processing、succeeded 或 failed。

integer

任务创建时间，Unix 毫秒时间戳。

integer

任务更新时间，Unix 毫秒时间戳。

string

存在时返回自定义任务 ID。

按任务 ID 查询

GET /kling/v2/tasks?task_ids=TASK_ID

cURL

curl --request GET \
  --url 'https://www.anyfast.ai/kling/v2/tasks?task_ids=TASK_ID' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

查询参数

string

必填

一个或多个系统生成的任务 ID。查询多个任务时使用英文逗号分隔。

任务结果字段

200

{
  "code": 0,
  "data": [
    {
      "id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "status": "succeeded",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "outputs": [
        {
          "type": "video",
          "url": "https://example.com/generated-video.mp4",
          "duration": "5"
        }
      ]
    }
  ],
  "message": ""
}

integer

错误码，0 表示查询成功。

string

错误或状态信息。

object[]

匹配的异步任务。

string

系统生成的任务 ID。

string

submitted、processing、succeeded 或 failed。

integer

任务创建时间，Unix 毫秒时间戳。

integer

任务更新时间，Unix 毫秒时间戳。

object[]

生成结果。

string

当前模型固定为 video。

string

生成视频的临时链接。

string

生成视频时长，单位为秒。

生成的图片和视频链接会在 30 天后清理，请及时下载并保存成功结果。

概览

原生兼容端点

模型 API

kling-3.0-turbo

创建任务

请求头

请求体

多镜头提示词格式

创建响应

创建任务

请求头

请求体

首帧图要求

多镜头提示词格式

创建响应

按任务 ID 查询

请求头

查询参数

任务结果字段

​创建任务

​请求头

​请求体

​多镜头提示词格式

​创建响应

​创建任务

​请求头

​请求体

​首帧图要求

​多镜头提示词格式

​创建响应

​按任务 ID 查询

​请求头

​查询参数

​任务结果字段

创建任务

请求头

请求体

多镜头提示词格式

创建响应

创建任务

请求头

请求体

首帧图要求

多镜头提示词格式

创建响应

按任务 ID 查询

请求头

查询参数

任务结果字段