生成视频任务
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、时间戳与文件地址均为示意值,实际以平台返回为准。模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。