生成广告任务
OpenAPI Specification
yaml
openapi: 3.0.1
info:
title: ''
description: "本页接口说明详见下方接口定义;参数取值与返回以本平台实测为准。"
version: 1.0.0
paths:
/higgsfield/ads:
post:
summary: 生成广告任务
deprecated: false
description: "HIGGSFIELD.4 · 产品展示类广告视频生成"
tags:
- 视频模型/Higgsfield
parameters:
- name: Authorization
in: header
description: "该字段的取值与含义以本平台实际返回为准。"
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
default: Bearer {{YOUR_API_KEY}}
requestBody:
content:
application/json:
schema:
type: object
required:
- product_placement_sample_id
- image
properties:
product_placement_sample_id:
type: string
description: "广告动作模板 ID,可通过模板接口获取"
image:
type: array
description: "参考图片,一般为一张产品图片"
items:
type: string
size:
type: string
description: "输出视频尺寸"
examples:
- 1024x1024
examples: {}
responses:
'200':
description: "该字段的取值与含义以本平台实际返回为准。"
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: "提交任务时平台下发的标识,后续查状态时带上"
example:
id: 9c1e0a2b-7d44-4f10-9a53-2b1c8e6d0f11
headers: {}
security: []
components:
schemas: {}
securitySchemes: {}
servers: []
security: []
使用提示:本页接口的 Base URL 为
https://api.allyang.cn,请求头需携带Authorization: Bearer <令牌>(令牌在控制台「令牌管理」中创建)。示例中的任务 ID、时间戳与文件地址均为示意值,实际以平台返回为准。模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。