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
      }
    }
  }'

200

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

请求头

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 个字符。

创建响应

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
      }
    }
  }'

200

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

请求头

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 个字符。

创建响应

integer

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

string

错误或状态信息。

string

系统生成的请求 ID。

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

必填

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

200

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": [
    {
      "id": "893605946402811985",
      "status": "succeeded",
      "message": "string",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "external_id": "",
      "outputs": [
        {
          "type": "video",
          "id": "string",
          "url": "https://example.com/generated-video.mp4",
          "watermark_url": "string",
          "duration": "5"
        }
      ],
      "billing": [
        {
          "charge_type": "string",
          "amount": "string",
          "package_type": "video",
          "list_price": "string"
        }
      ]
    }
  ]
}

任务结果字段

object[]

匹配的异步任务。

string

系统生成的任务 ID。

string

submitted、processing、succeeded 或 failed。

string

任务状态信息或失败原因。

integer

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

integer

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

string

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

object[]

生成结果。

string

当前模型固定为 video。

string

生成的视频 ID。

string

生成视频的临时链接。

string

请求水印时返回的含水印视频链接。

string

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

object[]

任务扣减信息。

string

cash 表示额度扣减，unit 表示资源包扣减。

string

扣减的额度或资源包积分。

string

资源包类型，当前模型为 video。

string

charge_type 为 cash 时返回刊例价。

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

概览

原生兼容端点

模型 API

kling-3.0-turbo

创建任务

请求头

请求体

多镜头提示词格式

创建响应

创建任务

请求头

请求体

首帧图要求

多镜头提示词格式

创建响应

按任务 ID 查询

任务结果字段

​创建任务

​请求头

​请求体

​多镜头提示词格式

​创建响应

​创建任务

​请求头

​请求体

​首帧图要求

​多镜头提示词格式

​创建响应

​按任务 ID 查询

​任务结果字段

创建任务

请求头

请求体

多镜头提示词格式

创建响应

创建任务

请求头

请求体

首帧图要求

多镜头提示词格式

创建响应

按任务 ID 查询

任务结果字段