API Docs

生成广告任务

POST

{{BASE_URL}}/higgsfield/ads

最后修改时间：2025-06-27 06:13:36

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": "3hpZ2HB0xS688KnzMIwU16",
  "image": ["https://www.baidu.com/open.png"],
  "size": "1024x1024"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '{{BASE_URL}}/higgsfield/ads' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "product_placement_sample_id": "3hpZ2HB0xS688KnzMIwU16",
  "image": ["https://www.baidu.com/open.png"],
  "size": "1024x1024"
}'

返回响应

🟢200成功

application/json

Body

string

可选

任务ID，用于后续查询任务状态

示例

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

修改于 2025-06-27 06:13:36

生成演说任务

获取任务状态