kling-v2-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": "模糊，抖动",
    "duration": "5",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "watermark_info": {"enabled": false}
  }'

200

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

请求头

string

必填

Bearer 身份验证，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

固定为 application/json。

请求体

string

必填

固定为 kling-2.6。

string

必填

正向提示词，最长 2500 字符。

string

不希望出现在视频中的内容，最长 2500 字符。

object[]

音色引用列表，最多 2 个；每项填写音色管理接口返回的 voice_id。

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 控制是否同时生成含平台水印的结果。

指定音色

voice_list 最多包含 2 个音色。按列表顺序在提示词中写入 <<<voice_1>>>、<<<voice_2>>>，并将 sound 设为 on。

{
  "model_name": "kling-2.6",
  "prompt": "<<<voice_1>>>说：'欢迎来到今天的节目'",
  "voice_list": [{"voice_id": "voice-id"}],
  "duration": "5",
  "mode": "pro",
  "sound": "on",
  "aspect_ratio": "16:9"
}

运镜控制

camera_control.type 支持 simple、down_back、forward_up、right_turn_forward 和 left_turn_forward。simple 模式的 config 可设置 horizontal、vertical、pan、tilt、roll 或 zoom，范围均为 -10 到 10，且只能有一项非 0。

查询任务（单个）

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'

string

必填

创建任务接口返回的 task_id。

状态可能为 submitted、processing、succeed 或 failed。成功结果位于 data.task_result.videos，视频项包含 id、url、watermark_url 和 duration；失败原因位于 data.task_status_msg。

生成结果 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"
  }'

200

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

请求头

string

必填

Bearer 身份验证，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

固定为 application/json。

请求体

string

必填

固定为 kling-2.6。

string

首帧图片 URL 或原始 Base64；与 image_tail 至少填写一个。

string

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

string

正向提示词，最长 2500 字符。

string

负向提示词，最长 2500 字符。

object[]

最多 2 个音色，每项包含 voice_id。

string

默认值:"off"

可选 on 或 off；引用音色时必须为 on。

string

默认值:"std"

可选 std（720p）或 pro（1080p）。

string

默认值:"5"

可选 5 或 10 秒。

string

静态区域蒙版，URL 或原始 Base64。

object[]

动态运动笔刷，最多 6 组。

object

预设或自定义运镜控制。

object

通过 enabled 控制是否同时生成含水印结果。

图片要求

支持公开 URL 或原始 Base64；Base64 不要添加 data:image/...;base64, 前缀。
支持 JPG、JPEG、PNG；文件不超过 10 MB，宽高均不小于 300 px，宽高比为 1:2.5 到 2.5:1。
image 与 image_tail 至少填写一个。
image_tail、运动笔刷和 camera_control 三类控制不能同时使用。

运动笔刷

string

必填

动态区域蒙版，尺寸与输入图片一致。

object[]

必填

轨迹坐标列表；5 秒视频可填写 2–77 个坐标点。

integer

必填

横坐标，原点位于图片左下角。

integer

必填

纵坐标，原点位于图片左下角。

指定音色示例

{
  "model_name": "kling-2.6",
  "image": "https://example.com/person.png",
  "prompt": "<<<voice_1>>>让图中人物说：'欢迎大家'",
  "voice_list": [{"voice_id": "voice-id"}],
  "duration": "5",
  "mode": "pro",
  "sound": "on"
}

查询任务（单个）

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'

string

必填

图生视频任务 ID。

成功时，data.task_result.videos 返回 id、url、watermark_url 和 duration；data.final_unit_deduction 与 data.final_balance_deduction 描述最终扣减信息。

生成结果 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"
  }'

200

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

请求头

string

必填

Bearer 身份验证，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

固定为 application/json。

请求体

string

必填

固定为 kling-2.6。

string

补充画面内容或运镜说明，最长 2500 字符。

string

必填

角色参考图片 URL 或原始 Base64。

string

必填

动作参考视频的公开 URL。

object[]

可选主体引用，最多 1 个；使用时 character_orientation 必须为 video。

string

必填

旧版主体管理接口返回的主体 ID。

string

默认值:"yes"

是否保留动作参考视频原声，可选 yes 或 no。

string

必填

角色朝向参考，可选 image 或 video。

string

默认值:"std"

可选 std 或 pro。

object

通过 enabled 控制是否同时生成含水印结果。

素材要求

图片支持 JPG、JPEG、PNG，不超过 10 MB；宽高为 300–65536 px，宽高比为 1:2.5 到 2.5:1。人物应清晰露出头部、上半身或全身，避免遮挡和极端朝向。
视频支持 MP4、MOV，不超过 100 MB；宽高为 340–3850 px，时长至少 3 秒。
character_orientation: "image" 时视频最长 10 秒；设为 video 时最长 30 秒。
参考视频应为连续单镜头，人物保持在画面内，避免切镜、剧烈运镜和过快动作，建议只包含一个人物。

当动作难度较高或速度过快时，模型可能只提取有效的连续动作并生成短于上传视频的结果。只要提取到至少 3 秒连续有效动作，任务仍可能生成并产生费用，相关消耗不退还。建议适当降低动作难度与速度。

查询任务（单个）

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'

string

必填

动作控制任务 ID。

成功结果位于 data.task_result.videos；任务状态为 submitted、processing、succeed 或 failed。

生成结果 URL 会在 30 天后清理，请及时转存。

接口列表

操作	方法与路径
创建自定义音色	`POST /kling/v1/general/custom-voices`
查询单个自定义音色	`GET /kling/v1/general/custom-voices/{id}`
查询自定义音色列表	`GET /kling/v1/general/custom-voices`
查询预置音色列表	`GET /kling/v1/general/presets-voices`
删除自定义音色	`POST /kling/v1/general/delete-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": "旁白",
    "voice_url": "https://example.com/voice.mp3"
  }'

200

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

string

必填

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

string

公开可访问的 MP3、WAV、MP4 或 MOV 地址；与 video_id 至少填写一个。

string

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

音色素材应只包含一个清晰人声，时长 5–30 秒。创建任务状态可能为 submitted、processing、succeed 或 failed；成功后可取得 voice_id 和 trial_url。

查询单个自定义音色

cURL

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

成功结果包含 voice_id、voice_name、trial_url 和 owned_by。

查询音色列表

cURL

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

cURL

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

integer

默认值:1

页码，范围 1–1000。

integer

默认值:30

每页数量，范围 1–1000。

预置音色的 owned_by 为 kling，可以直接用于生成，但不能删除。

删除自定义音色

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/general/delete-voices \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"voice_id":"VOICE_ID"}'

string

必填

需要删除的自定义音色 ID。

本页使用可灵旧版请求结构。AnyFast 在旧版接口路径前增加 /kling 路由前缀；页面不包含新版模型独立端点，也不列出当前未开放的任务列表查询。

概览

原生兼容端点

模型 API

创建任务

请求头

请求体

指定音色

运镜控制

查询任务（单个）

创建任务

请求头

请求体

图片要求

运动笔刷

指定音色示例

查询任务（单个）

创建任务

请求头

请求体

素材要求

查询任务（单个）

接口列表

创建自定义音色

查询单个自定义音色

查询音色列表

删除自定义音色

​创建任务

​请求头

​请求体

​指定音色

​运镜控制

​查询任务（单个）

​创建任务

​请求头

​请求体

​图片要求

​运动笔刷

​指定音色示例

​查询任务（单个）

​创建任务

​请求头

​请求体

​素材要求

​查询任务（单个）

​接口列表

​创建自定义音色

​查询单个自定义音色

​查询音色列表

​删除自定义音色

创建任务

请求头

请求体

指定音色

运镜控制

查询任务（单个）

创建任务

请求头

请求体

图片要求

运动笔刷

指定音色示例

查询任务（单个）

创建任务

请求头

请求体

素材要求

查询任务（单个）

接口列表

创建自定义音色

查询单个自定义音色

查询音色列表

删除自定义音色