# 生成演说任务

**方法**: `POST`
**路径**: `/higgsfield/speech`

HIGGSFIELD.3 生成演说视频 [人物说话]

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
可选
One of:
object
object
avatar_preset_id
string
必需
演说模板ID，可通过模板API获取
prompt
string
提示词
必需
width
integer
视频宽度
必需
height
integer
视频高度
必需
image
array
[string]
必需
自传头像，支持URL和base64
audio
string
必需
语音URL文件(wav/mp3)，时长不能超过13s，与speak二选一
speak
object
可选
文本转语音配置，与audio二选一
示例
{
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/higgsfield/speech' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
id
string
可选
任务ID，用于后续查询任务状态
```

#### 示例

```json
{
    "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22"
}
```