众扬汇 AI 开放平台 API 文档

生成广告任务

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、时间戳与文件地址均为示意值,实际以平台返回为准。

模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。