# 获取演说模板

**方法**: `GET`
**路径**: `/higgsfield/tpl/avatar-presets`

## 请求参数

### Query 参数

```text
size
integer
返回的模板数量
可选
示例:
30
search
string
搜索关键词
可选
```

### Header 参数

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

### Body 参数 application/json

```text
size
integer
每页返回数量
可选
默认值:
30
search
string
搜索关键词
可选
示例
{
"size"
:
30
,
"search"
:
"string"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request GET '/higgsfield/tpl/avatar-presets?size=30&search=' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "size": 30,
    "search": "string"
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
items
array
[object]
必需
id
string
可选
name
string
可选
media
object
可选
params
object
可选
total
integer
必需
cursor
integer
必需
```

#### 示例

```json
{
  "items": [
    {
      "id": "7f1xkmlzvtCNncSqUYMTbU",
      "name": "Selfie",
      "media": {
        "url": "https://d1xarpci4ikg0w.cloudfront.net/7d1ce555-ebb4-46ca-8932-d3f6b2d15459.mp4",
        "type": "video",
        "width": 500,
        "height": 888,
        "thumbnail_url": "https://d1xarpci4ikg0w.cloudfront.net/d10ddb13-22f7-4182-ba8c-0007fe7f7369.webp"
      },
      "params": {
        "quality": "low",
        "chunks_count": 3
      }
    }
  ],
  "total": 28,
  "cursor": 2
}

```