生成广告任务

方法: POST路径: /higgsfield/ads

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

请求参数

Header 参数

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

Body 参数 application/json

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

请求示例代码

Shell

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

响应结构

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

示例

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