Kling 数字人

需要将文本转换为语音时，先调用 TTS，再把返回的 audio_id 传给数字人生成接口。如果已有音频文件，可通过 sound_file 直接提交并跳过 TTS。

Avatar
TTS

创建任务

POST /kling/v1/videos/avatar/image2video

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/avatar/image2video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "image": "https://example.com/portrait.png",
    "audio_id": "932365483050274872",
    "prompt": "人物自然看向镜头说话，神态友好，轻微点头。",
    "mode": "std",
    "watermark_info": {"enabled": true}
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

图片公网 URL 或纯 Base64。支持 JPG、JPEG、PNG，不超过 10 MB；宽高均不小于 300 px，比例介于 1:2.5～2.5:1。Base64 不要包含 data URI 前缀。

string

30 天内生成的音频 ID，音频时长 2～300 秒。与 sound_file 必须二选一。

string

音频公网 URL 或纯 Base64。支持 MP3、WAV、M4A、AAC，不超过 5 MB，时长 2～300 秒。与 audio_id 必须二选一。

string

动作、情绪和运镜提示词，最长 2,500 个字符。

string

默认值:"std"

生成模式：std 或 pro。

object

水印配置。

boolean

是否生成含水印结果。

string

任务状态通知的公网回调地址。

创建响应

200

{
  "id": "asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX",
  "task_id": "asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX",
  "object": "video",
  "model": "kling-v1",
  "status": "queued",
  "progress": 0,
  "created_at": 1790319846
}

string

AnyFast 任务 ID。

string

AnyFast 任务 ID，与 id 相同。

string

返回对象类型，本接口为 video。

string

接口返回的底层请求模型标识。

string

AnyFast 初始状态；任务受理后为 queued。

integer

初始进度百分比。

integer

创建时间，Unix 秒时间戳。

查询任务

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

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/avatar/image2video/asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX \
  --header 'Authorization: Bearer YOUR_API_KEY'

请求头和路径

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

必填

创建数字人时返回的 AnyFast 任务 ID。

响应

200

{
  "code": 0,
  "message": "",
  "data": {
    "task_id": "asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/digital-human.mp4",
          "duration": "5"
        }
      ]
    },
    "created_at": 1790319846000,
    "updated_at": 1790320090000
  }
}

integer

业务结果码，0 表示成功。

string

业务信息，成功时可能为空。

string

AnyFast 任务 ID。

string

任务状态：submitted、processing、succeed 或 failed。中间状态可能重复出现，也可能在 submitted 与 processing 之间切换；只有 succeed 和 failed 是终态。

string

任务失败时的错误信息。

object[]

任务成功后返回的视频结果。

string

生成视频 URL。

string

接口返回的视频时长，单位为秒。

integer

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

integer

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

生成语音

POST /kling/v1/audio/tts

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/audio/tts \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "你好，欢迎使用 AnyFast 数字人服务。",
    "voice_id": "oversea_male1",
    "voice_language": "zh",
    "voice_speed": 1.0
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

需要合成的文本，最长 1,000 个字符。

string

必填

从 Kling AI Voice List 选择音色 ID；表中语言必须与 voice_language 一致。

string

默认值:"zh"

必填

音色语种，支持 zh、en。

number

默认值:1

语速范围 0.8～2.0，超出一位小数的部分会四舍五入。

响应

200

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "request_01J8K7E7H4T7FQ6V6K6A",
  "data": {
    "task_id": "tts_task_01J8K7E7H4",
    "task_status": "succeed",
    "task_result": {
      "audios": [
        {
          "id": "932365483050274872",
          "url": "https://example.com/generated-speech.mp3",
          "duration": "4.067"
        }
      ]
    },
    "created_at": 1790321772436,
    "updated_at": 1790321774387,
    "final_unit_deduction": "0.05",
    "final_balance_deduction": {
      "quota": "0",
      "list_price": "0"
    }
  }
}

integer

业务结果码，0 表示成功。

string

业务结果信息。

string

用于排查问题的请求 ID。

string

TTS 任务 ID。

string

TTS 状态；同步成功时返回 succeed。

object[]

生成的音频结果。

string

数字人和对口型接口可使用的音频 ID。

string

生成音频的 URL。

string

音频时长，单位为秒。

string

Kling 最终扣减 Unit。

object

供应商返回的余额扣减信息。

integer

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

integer

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

概览

原生兼容端点

模型 API

Kling 数字人

创建任务

请求头

请求体

创建响应

查询任务

请求头和路径

响应

生成语音

请求头

请求体

响应

​创建任务

​请求头

​请求体

​创建响应

​查询任务

​请求头和路径

​响应

​生成语音

​请求头

​请求体

​响应

创建任务

请求头

请求体

创建响应

查询任务

请求头和路径

响应

生成语音

请求头

请求体

响应