# 生成广告任务

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

HIGGSFIELD.4 生成广告视频 [产品展示]

## 请求参数

### Header 参数

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

### Body 参数 application/json

```text
product_placement_sample_id
string
必需
广告动作模板ID，可从官网获取
image
array
[string]
必需
参考图片，通常为一张产品图片
size
string
视频尺寸
可选
示例:
1024x1024
示例
{
"product_placement_sample_id"
:
"string"
,
"image"
:
[
"string"
]
,
"size"
:
"1024x1024"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/higgsfield/ads' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_placement_sample_id": "string",
    "image": [
        "string"
    ],
    "size": "1024x1024"
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

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

#### 示例

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