## 创建任务
`POST /kling/v1/videos/avatar/image2video`
```bash cURL theme={null}
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}
}'
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
数据交换格式。
## 请求体
图片公网 URL 或纯 Base64。支持 JPG、JPEG、PNG，不超过 10 MB；宽高均不小于 300 px，比例介于 1:2.5～2.5:1。Base64 不要包含 data URI 前缀。
30 天内生成的音频 ID，音频时长 2～300 秒。与 `sound_file` 必须二选一。
音频公网 URL 或纯 Base64。支持 MP3、WAV、M4A、AAC，不超过 5 MB，时长 2～300 秒。与 `audio_id` 必须二选一。
动作、情绪和运镜提示词，最长 2,500 个字符。
生成模式：`std` 或 `pro`。
水印配置。
是否生成含水印结果。
任务状态通知的公网回调地址。
## 创建响应
```json 200 theme={null}
{
"id": "asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX",
"task_id": "asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX",
"object": "video",
"model": "kling-v1",
"status": "queued",
"progress": 0,
"created_at": 1790319846
}
```
AnyFast 任务 ID。
AnyFast 任务 ID，与 `id` 相同。
返回对象类型，本接口为 `video`。
接口返回的底层请求模型标识。
AnyFast 初始状态；任务受理后为 `queued`。
初始进度百分比。
创建时间，Unix 秒时间戳。
## 查询任务
`GET /kling/v1/videos/avatar/image2video/{task_id}`
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/kling/v1/videos/avatar/image2video/asyntask_6prd3xHk76S1sTivIgGjQzrA4ziDrRCX \
--header 'Authorization: Bearer YOUR_API_KEY'
```
## 请求头和路径
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
创建数字人时返回的 AnyFast 任务 ID。
## 响应
```json 200 theme={null}
{
"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
}
}
```
业务结果码，`0` 表示成功。
业务信息，成功时可能为空。
AnyFast 任务 ID。
任务状态：`submitted`、`processing`、`succeed` 或 `failed`。中间状态可能重复出现，也可能在 `submitted` 与 `processing` 之间切换；只有 `succeed` 和 `failed` 是终态。
任务失败时的错误信息。
任务成功后返回的视频结果。
生成视频 URL。
接口返回的视频时长，单位为秒。
创建时间，Unix 毫秒时间戳。
更新时间，Unix 毫秒时间戳。
## 生成语音
`POST /kling/v1/audio/tts`
```bash cURL theme={null}
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
}'
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
数据交换格式。
## 请求体
需要合成的文本，最长 1,000 个字符。
从 [Kling AI Voice List](https://docs.qingque.cn/s/home/eZQDvafJ4vXQkP8T9ZPvmye8S?identityId=2E1MlYrrPk4) 选择音色 ID；表中语言必须与 `voice_language` 一致。
音色语种，支持 `zh`、`en`。
语速范围 `0.8`～`2.0`，超出一位小数的部分会四舍五入。
## 响应
```json 200 theme={null}
{
"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"
}
}
}
```
业务结果码，`0` 表示成功。
业务结果信息。
用于排查问题的请求 ID。
TTS 任务 ID。
TTS 状态；同步成功时返回 `succeed`。
生成的音频结果。
数字人和对口型接口可使用的音频 ID。
生成音频的 URL。
音频时长，单位为秒。
Kling 最终扣减 Unit。
供应商返回的余额扣减信息。
创建时间，Unix 毫秒时间戳。
更新时间，Unix 毫秒时间戳。