众扬汇 AI 开放平台 API 文档

生成视频任务

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: "本页接口说明详见下方接口定义;参数取值与返回以本平台实测为准。"
  version: 1.0.0
paths:
  /higgsfield/generate:
    post:
      summary: 生成视频任务
      deprecated: false
      description: "本页接口「生成视频任务」对应 POST /higgsfield/generate(归属:视频模型/Higgsfield)。"
      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:
                - model
                - motion_id
                - prompt
                - image
              properties:
                model:
                  type: string
                  description: "模型类型,可选取值:standard、lite、turbo(是否在售以模型广场为准)"
                  enum:
                    - standard
                    - lite
                    - turbo
                motion_id:
                  type: string
                  description: "动作模板 ID,可通过模板接口获取"
                prompt:
                  type: string
                  description: "视频生成用提示词"
                enhance_prompt:
                  type: boolean
                  description: "是否开启提示词增强"
                  default: true
                seed:
                  type: integer
                  description: "随机种子,取值范围 1–1000000"
                  minimum: 1
                  maximum: 1000000
                width:
                  type: integer
                  description: "输出视频宽度(像素)"
                height:
                  type: integer
                  description: "输出视频高度(像素)"
                image:
                  type: array
                  description: "视频帧图片地址,支持公网 URL 与 base64,最少 1 张、最多 2 张"
                  items:
                    type: string
                  minItems: 1
                  maxItems: 2
            examples: {}
      responses:
        '200':
          description: "该字段的取值与含义以本平台实际返回为准。"
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: "提交任务时平台下发的标识,后续查状态时带上"
              example:
                type: object
                properties:
                  id:
                    type: string
                    description: "提交任务时平台下发的标识,后续查状态时带上"
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

使用提示:本页接口的 Base URL 为 https://api.allyang.cn,请求头需携带 Authorization: Bearer <令牌>(令牌在控制台「令牌管理」中创建)。示例中的任务 ID、时间戳与文件地址均为示意值,实际以平台返回为准。

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