# 数字人

**方法**: `POST`
**路径**: `/kling/v1/videos/avatar/image2video`

本文档不实时更新，完整版请查看官方文档：<https://app.klingai.com/cn/dev/document-api/apiReference/model/avatar>

## 请求参数

### Header 参数

```text
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
video_id
string
必需
prompt
string
必需
示例
{
"image"
:
"string"
,
"audio_id"
:
"string"
,
"sound_file"
:
"string"
,
"prompt"
:
"string"
,
"mode"
:
"string"
,
"callback_url"
:
"string"
,
"external_task_id"
:
"string"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/videos/avatar/image2video' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image": "string",
    "audio_id": "string",
    "sound_file": "string",
    "prompt": "string",
    "mode": "string",
    "callback_url": "string",
    "external_task_id": "string"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CmJ8DGePZioAAAAAAFIvOQ",
    "data": {
        "task_id": "CmJ8DGePZioAAAAAAFIvOQ",
        "task_status": "submitted",
        "created_at": 1737628288136,
        "updated_at": 1737628288136
    }
}
```