1. kling
梧柏API使用文档
WHBAI · Kling
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 可灵 Kling
    • 文生音效
    • 文生视频
    • 图生视频
    • 文生图
    • 查询文生视频任务
    • Omni-Video
  • kling
    • 对口型
      POST
    • 虚拟试穿
      POST
    • 视频延长
      POST
    • 视频特效
      POST
    • 多图参考生视频
      POST
    • 查询任务(免费)
      GET
    • 查询任务(单个)
      GET
    • Omni-Image
      POST
    • 查询任务(单个)
      GET
    • 查询任务(单个)
      GET
    • 初始化待编辑视频
      POST
    • 增加视频选区
      POST
    • 删减视频选区
      POST
    • 预览已选区视频
      POST
    • 多模态视频
      POST
    • 查询任务(单个)
      GET
    • 查询任务(单个)
      GET
    • 查询任务(单个)
      GET
    • 查询任务(单个)
      GET
    • 多图参考生图
      POST
    • 查询任务(单个)
      GET
    • 文生视频
      POST
    • 图生视频
      POST
    • 查询视频
      GET
    • 查询任务(单个)
      GET
    • 扩图
      POST
    • 查询任务(单个)
      GET
    • 图像识别
      POST
    • 数字人
      POST
    • 查询任务(单个)
      GET
    • 查询任务(单个)
      GET
    • 视频生音效
      POST
    • 查询任务(单个)
      GET
    • 语音合成
      POST
    • 查询任务(单个)
      GET
    • 人脸识别
      POST
    • 对口型
      POST
    • 查询任务(单个)
      GET
    • 自定义音色
      POST
    • 查询自定义音色(单个)
      GET
    • 查询官方音色
      GET
    • 删除自定义音色
      POST
    • 动作控制
      POST
    • 查询任务(单个)
      GET
    • 主体(旧)
      POST
    • 主体(新版本)
      POST
    • 查询自定义主体(单个新版本)
      GET
    • 查询官方主体(列表新版本)
      GET
    • 删除自定义主体(新版本)
      POST
  • 数据模型
    • KlingTaskSubmitResponse
    • KlingTaskQueryResponse
    • KlingText2VideoRequest
    • KlingImage2VideoRequest
    • PostKlingV1ImagesGenerationsRequest
    • KlingOmniVideoRequest
    • NewApiError
  1. kling

自定义音色

POST
/kling/v1/general/custom-voices

网站中的模型与调用示例#

自定义音色#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "callback_url": {
      "type": "string"
    },
    "external_task_id": {
      "type": "string"
    },
    "video_id": {
      "description": "历史作品ID,可通过引用历史作品提供音频素材\n\n仅满足以下条件的视频可以用于定制音色:\n使用V2.6版本模型生成且开启sound参数值为on的视频\n通过数字人API生成的视频\n通过对口型API生成的视频\n音频中人生需干净无杂音,有且只能有一种人声,时长不短于5秒且不长于30秒",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "historical work ID, provide audio via historical works only videos meeting these conditions can customize a voice: videos from V2.6 with sound=on\nvideos from the digital-human API\nvideos from the lip-sync API\naudio must have clean speech without noise, exactly one clean voice, duration between 5s and 30s"
        }
      }
    },
    "voice_name": {
      "description": "音色名称",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Voice name"
        }
      }
    },
    "voice_url": {
      "description": "音色数据文件获取链接\n支持.mp3/.wav/.mp4/.mov格式的音视频文件\n音频中人生需干净无杂音,有且只能有一种人声,时长不短于5秒且不长于30秒",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "voice sample file URL\nsupports .mp3/.wav/.mp4/.mov A/V files\naudio must have clean speech without noise, exactly one clean voice, duration between 5s and 30s"
        }
      }
    }
  },
  "required": [
    "voice_name"
  ]
}

响应示例 · 示例 1#

{
  "callback_url": "",
  "external_task_id": "",
  "video_id": "830460928805724256",
  "voice_name": "测试音色",
  "voice_url": ""
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Header 参数

Body 参数application/json必填

示例
{
    "voice_name": "string",
    "voice_url": "string",
    "video_id": "string",
    "callback_url": "string",
    "external_task_id": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/kling/v1/general/custom-voices' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "voice_name": "string",
    "voice_url": "string",
    "video_id": "string",
    "callback_url": "string",
    "external_task_id": "string"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "voice_name": "测试音色",
    "voice_url": "",
    "video_id": "830460928805724256",
    "callback_url": "",
    "external_task_id": ""
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:09
上一页
查询任务(单个)
下一页
查询自定义音色(单个)
Built with