kling-v2-6

本页按能力整合 Kling 2.6 的创建、查询与管理接口。每个请求和响应示例均与对应字段说明分开显示。

文生视频
图生视频
运动控制
音色管理

创建任务

POST /kling/v1/videos/text2video

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/text2video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.6",
    "prompt": "一只柯基在日落海滩奔跑，海浪掠过沙滩",
    "negative_prompt": "blurry, shaky",
    "duration": "5",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "watermark_info": {"enabled": false}
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

请求体

string

必填

固定为 kling-2.6。

string

必填

正向提示词，最多 2,500 个字符。

string

需要避免的内容，最多 2,500 个字符。

object[]

最多两个音色。每项包含音色管理返回的 voice_id。按列表顺序在提示词中使用 <<<voice_1>>> 和 <<<voice_2>>>，并将 sound 设为 on。

string

默认值:"off"

on 或 off；使用 voice_list 时必须为 on。

string

默认值:"std"

std 为 720p，pro 为 1080p。

string

默认值:"5"

固定为 5 或 10 秒。

string

默认值:"16:9"

16:9、9:16 或 1:1。

object

预设或自定义镜头运动。

object

使用 enabled 请求额外的带水印结果。

镜头控制

camera_control.type 支持 simple、down_back、forward_up、right_turn_forward 和 left_turn_forward。simple 模式仅设置 horizontal、vertical、pan、tilt、roll 或 zoom 中的一个非零值，范围为 -10 至 10。

创建响应

200

{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v2-6",
  "status": "queued",
  "progress": 0,
  "created_at": 1773130665
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的公开模型 ID。

string

初始状态，固定为 queued。

integer

初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

按 ID 查询任务

GET /kling/v1/videos/text2video/{task_id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/text2video/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

路径参数

string

必填

创建接口返回的文生视频任务 ID。

任务结果

200

{
  "code": 0,
  "message": "",
  "data": {
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {"url": "https://example.com/result.mp4", "duration": "5"}
      ]
    },
    "created_at": 1784720890000,
    "updated_at": 1784720949000
  }
}

integer

0 表示查询成功。

string

错误信息；成功时为空。

string

查询的任务 ID。

string

submitted、processing、succeed 或 failed。

string

任务失败时的错误详情。

object[]

成功后返回的生成视频。

string

临时视频下载 URL。

string

实际视频时长，单位为秒。

integer

创建时间，Unix 毫秒级时间戳。

integer

更新时间，Unix 毫秒级时间戳。

生成结果 URL 会在 30 天后删除，请及时下载保存。

创建任务

POST /kling/v1/videos/image2video

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/image2video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.6",
    "image": "https://example.com/first-frame.png",
    "image_tail": "https://example.com/end-frame.png",
    "prompt": "镜头缓慢后移，人物微笑",
    "duration": "5",
    "mode": "pro",
    "sound": "off"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

请求体

string

必填

固定为 kling-2.6。

string

首帧 URL 或原始 Base64；image 与 image_tail 至少传一个。

string

尾帧；不能与 dynamic_masks、static_mask 或 camera_control 同时使用。

string

正向提示词，最多 2,500 个字符。

string

负向提示词，最多 2,500 个字符。

object[]

最多两个包含 voice_id 的音色；使用时将 sound 设为 on。

string

默认值:"off"

on 或 off。

string

默认值:"std"

std 为 720p，pro 为 1080p。

string

默认值:"5"

5 或 10 秒。

string

静态运动遮罩 URL 或原始 Base64。

object[]

最多六个动态运动笔刷遮罩。

string

必填

与输入图片尺寸一致的动态区域遮罩。

object[]

必填

轨迹坐标；5 秒视频支持 2–77 个点。

integer

必填

以图片左下角为原点的 X 坐标。

integer

必填

以图片左下角为原点的 Y 坐标。

object

预设或自定义镜头运动。

object

使用 enabled 请求额外的带水印结果。

图片要求

使用公网 URL 或不带 data URI 前缀的原始 Base64。支持 JPG、JPEG 和 PNG；文件不超过 10 MB，两边至少 300 px，宽高比在 1:2.5 至 2.5:1 之间。尾帧、运动笔刷与镜头控制不能同时使用。

创建响应

200

{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v2-6",
  "status": "queued",
  "progress": 0,
  "created_at": 1773130665
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的公开模型 ID。

string

初始状态，固定为 queued。

integer

初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

按 ID 查询任务

GET /kling/v1/videos/image2video/{task_id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/image2video/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

路径参数

string

必填

创建接口返回的图生视频任务 ID。

任务结果

200

{
  "code": 0,
  "message": "",
  "data": {
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {"url": "https://example.com/result.mp4", "duration": "5"}
      ]
    },
    "created_at": 1784720890000,
    "updated_at": 1784720949000
  }
}

integer

0 表示查询成功。

string

错误信息；成功时为空。

string

查询的任务 ID。

string

submitted、processing、succeed 或 failed。

string

任务失败时的错误详情。

object[]

成功后返回的生成视频。

string

临时视频下载 URL。

string

实际视频时长，单位为秒。

integer

创建时间，Unix 毫秒级时间戳。

integer

更新时间，Unix 毫秒级时间戳。

生成结果 URL 会在 30 天后删除，请及时下载保存。

创建任务

POST /kling/v1/videos/motion-control

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/motion-control \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.6",
    "image_url": "https://example.com/character.png",
    "video_url": "https://example.com/motion.mp4",
    "prompt": "保持角色一致并复现参考动作",
    "character_orientation": "video",
    "keep_original_sound": "yes",
    "mode": "pro"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

请求体

string

必填

固定为 kling-2.6。

string

补充视觉或镜头说明，最多 2,500 个字符。

string

必填

角色图片 URL 或原始 Base64。

string

必填

动作参考视频的公网 URL。

object[]

最多一个旧版元素；使用时 character_orientation 必须为 video。

string

必填

旧版元素管理 API 返回的元素 ID。

string

默认值:"yes"

是否保留参考视频音频：yes 或 no。

string

必填

角色朝向来源：image 或 video。

string

默认值:"std"

std 或 pro。

object

使用 enabled 请求额外的带水印结果。

素材要求

图片支持 JPG/JPEG/PNG，不超过 10 MB，每边 300–65,536 px，宽高比 1:2.5 至 2.5:1。视频支持 MP4/MOV，不超过 100 MB，每边 340–3,850 px，至少 3 秒；角色朝向为 image 时最长 10 秒，为 video 时最长 30 秒。

创建响应

200

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "request-id",
  "data": {"task_id": "task-id", "task_status": "submitted"}
}

integer

0 表示请求已接受。

string

响应消息。

string

请求追踪 ID。

string

运动控制任务 ID。

string

初始任务状态。

按 ID 查询任务

GET /kling/v1/videos/motion-control/{task_id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/motion-control/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

路径参数

string

必填

创建接口返回的运动控制任务 ID。

任务结果

200

{
  "code": 0,
  "message": "",
  "data": {
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {"url": "https://example.com/result.mp4", "duration": "5"}
      ]
    },
    "created_at": 1784720890000,
    "updated_at": 1784720949000
  }
}

integer

0 表示查询成功。

string

错误信息；成功时为空。

string

查询的任务 ID。

string

submitted、processing、succeed 或 failed。

string

任务失败时的错误详情。

object[]

成功后返回的生成视频。

string

临时视频下载 URL。

string

实际视频时长，单位为秒。

integer

创建时间，Unix 毫秒级时间戳。

integer

更新时间，Unix 毫秒级时间戳。

生成结果 URL 会在 30 天后删除，请及时下载保存。

创建自定义音色

POST /kling/v1/general/custom-voices

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/general/custom-voices \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "voice_name": "Narrator",
    "voice_url": "https://example.com/voice.mp3"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

请求体

string

必填

自定义音色名称，最多 20 个字符。

string

公网 MP3、WAV、MP4 或 MOV URL；与 video_id 至少传一个。

string

符合条件的历史生成视频 ID；与 voice_url 至少传一个。

音源需为单人清晰语音，时长 5–30 秒。

创建响应

200

{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-voices",
  "status": "queued",
  "progress": 0,
  "created_at": 1773130665
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的公开模型 ID。

string

初始状态，固定为 queued。

integer

初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

查询自定义音色

GET /kling/v1/general/custom-voices/{id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/general/custom-voices/VOICE_TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

必填

创建音色接口返回的任务 ID。

自定义音色结果

200

{
  "code": "0",
  "message": "",
  "requestId": "request-id",
  "data": {
    "task_id": "VOICE_TASK_ID",
    "task_status": "succeed",
    "task_result": {
      "voices": [{"voice_id": "voice-id", "voice_name": "Narrator", "trial_url": "https://example.com/trial.mp3", "owned_by": "self", "status": "succeed"}]
    }
  }
}

string

业务状态码。

string

响应消息。

string

请求追踪 ID。

string

音色任务 ID。

string

submitted、processing、succeed 或 failed。

object[]

音色列表。

string

可在视频请求中使用的音色 ID。

string

音色名称。

string

音色试听 URL。

string

自定义音色为 self，当前预设音色为 vod。

查询预设音色列表

GET /kling/v1/general/presets-voices?pageNum=1&pageSize=30

cURL

curl --request GET \
  --url 'https://www.anyfast.ai/kling/v1/general/presets-voices?pageNum=1&pageSize=30' \
  --header 'Authorization: Bearer YOUR_API_KEY'

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

integer

默认值:1

页码，范围 1–1,000。

integer

默认值:30

每页数量，范围 1–1,000。

预设音色结果

200

{
  "code": "0",
  "message": "",
  "requestId": "request-id",
  "data": [
    {
      "task_id": "preset-task-id",
      "task_status": "succeed",
      "task_result": {
        "voices": [{"voice_id": "preset-voice-id", "voice_name": "Warm narrator", "trial_url": "https://example.com/preset.mp3", "owned_by": "vod", "status": "succeed"}]
      }
    }
  ]
}

string

业务状态码。

string

响应消息。

string

请求追踪 ID。

string

音色任务 ID。

string

submitted、processing、succeed 或 failed。

object[]

音色列表。

string

可在视频请求中使用的音色 ID。

string

音色名称。

string

音色试听 URL。

string

自定义音色为 self，当前预设音色为 vod。

本页使用 Kling 旧版请求结构，AnyFast 在路径前添加 /kling 路由前缀。

概览

原生兼容端点

模型 API

创建任务

请求头

请求体

镜头控制

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

创建任务

请求头

请求体

图片要求

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

创建任务

请求头

请求体

素材要求

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

创建自定义音色

请求头

请求体

创建响应

查询自定义音色

自定义音色结果

查询预设音色列表

预设音色结果

​创建任务

​请求头

​请求体

​镜头控制

​创建响应

​按 ID 查询任务

​请求头

​路径参数

​任务结果

​创建任务

​请求头

​请求体

​图片要求

​创建响应

​按 ID 查询任务

​请求头

​路径参数

​任务结果

​创建任务

​请求头

​请求体

​素材要求

​创建响应

​按 ID 查询任务

​请求头

​路径参数

​任务结果

​创建自定义音色

​请求头

​请求体

​创建响应

​查询自定义音色

​自定义音色结果

​查询预设音色列表

​预设音色结果

创建任务

请求头

请求体

镜头控制

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

创建任务

请求头

请求体

图片要求

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

创建任务

请求头

请求体

素材要求

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

创建自定义音色

请求头

请求体

创建响应

查询自定义音色

自定义音色结果

查询预设音色列表

预设音色结果