# Higgsfield 视频模型

# 🎬 Higgsfield 视频生成 API 使用指南

## 📋 概述

Higgsfield 提供多种视频生成功能，包括基础图生视频、演说视频和广告视频。本指南将帮助您了解何时使用哪个接口。

## 🎯 接口使用场景

### 1\. 基础图生视频 - `/higgsfield/generate`

**适用场景：**

将静态图片转换为动态视频

创建短视频内容

制作动画效果

社交媒体内容创作

**何时使用：**

✅ 有静态图片，想要添加动作效果

✅ 需要创建循环动画

✅ 制作产品展示视频

✅ 创建艺术动画作品

**不适用：**

❌ 需要人物说话的视频

❌ 需要广告特效的商业视频

* * *

### 2\. 演说视频 - `/higgsfield/speak`

**适用场景：**

数字人说话视频

教育培训内容

客服视频

个人vlog

**何时使用：**

✅ 需要人物开口说话

✅ 制作教学视频

✅ 客服自动回复视频

✅ 虚拟主播内容

✅ 有音频文件需要配合人物口型

**音频来源选择：**

**上传音频文件**：已有录制好的音频（wav/mp3格式）

**文本转语音**：需要从文字生成语音，可选择不同的语音ID和音效

* * *

### 3\. 广告视频 - `/higgsfield/ads`

**适用场景：**

产品广告制作

电商推广视频

品牌宣传

营销活动

**何时使用：**

✅ 产品需要专业广告效果

✅ 电商平台产品推广

✅ 品牌营销活动

✅ 需要特殊的产品展示动效

**注意：**

成本较高（13点，是基础价格的2.6倍）

模板需要从官网获取

专门针对商业广告场景优化

* * *

## 🔄 标准工作流程

### 方案A：基础图生视频

#mermaid-mermaid-1{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-mermaid-1 .error-icon{fill:#552222;}#mermaid-mermaid-1 .error-text{fill:#552222;stroke:#552222;}#mermaid-mermaid-1 .edge-thickness-normal{stroke-width:2px;}#mermaid-mermaid-1 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-mermaid-1 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-mermaid-1 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-mermaid-1 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-mermaid-1 .marker{fill:#333333;stroke:#333333;}#mermaid-mermaid-1 .marker.cross{stroke:#333333;}#mermaid-mermaid-1 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-mermaid-1 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-mermaid-1 .cluster-label text{fill:#333;}#mermaid-mermaid-1 .cluster-label span,#mermaid-mermaid-1 p{color:#333;}#mermaid-mermaid-1 .label text,#mermaid-mermaid-1 span,#mermaid-mermaid-1 p{fill:#333;color:#333;}#mermaid-mermaid-1 .node rect,#mermaid-mermaid-1 .node circle,#mermaid-mermaid-1 .node ellipse,#mermaid-mermaid-1 .node polygon,#mermaid-mermaid-1 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-mermaid-1 .flowchart-label text{text-anchor:middle;}#mermaid-mermaid-1 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-mermaid-1 .node .label{text-align:center;}#mermaid-mermaid-1 .node.clickable{cursor:pointer;}#mermaid-mermaid-1 .arrowheadPath{fill:#333333;}#mermaid-mermaid-1 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-mermaid-1 .flowchart-link{stroke:#333333;fill:none;}#mermaid-mermaid-1 .edgeLabel{background-color:#e8e8e8;text-align:center;}#mermaid-mermaid-1 .edgeLabel rect{opacity:0.5;background-color:#e8e8e8;fill:#e8e8e8;}#mermaid-mermaid-1 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-mermaid-1 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-mermaid-1 .cluster text{fill:#333;}#mermaid-mermaid-1 .cluster span,#mermaid-mermaid-1 p{color:#333;}#mermaid-mermaid-1 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-mermaid-1 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-mermaid-1 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}

否

是

准备图片

获取动作模板列表

选择合适的motion\_id

调用生成接口

查询任务状态

任务完成?

获取视频URL

### 方案B：演说视频

#mermaid-mermaid-2{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-mermaid-2 .error-icon{fill:#552222;}#mermaid-mermaid-2 .error-text{fill:#552222;stroke:#552222;}#mermaid-mermaid-2 .edge-thickness-normal{stroke-width:2px;}#mermaid-mermaid-2 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-mermaid-2 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-mermaid-2 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-mermaid-2 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-mermaid-2 .marker{fill:#333333;stroke:#333333;}#mermaid-mermaid-2 .marker.cross{stroke:#333333;}#mermaid-mermaid-2 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-mermaid-2 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-mermaid-2 .cluster-label text{fill:#333;}#mermaid-mermaid-2 .cluster-label span,#mermaid-mermaid-2 p{color:#333;}#mermaid-mermaid-2 .label text,#mermaid-mermaid-2 span,#mermaid-mermaid-2 p{fill:#333;color:#333;}#mermaid-mermaid-2 .node rect,#mermaid-mermaid-2 .node circle,#mermaid-mermaid-2 .node ellipse,#mermaid-mermaid-2 .node polygon,#mermaid-mermaid-2 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-mermaid-2 .flowchart-label text{text-anchor:middle;}#mermaid-mermaid-2 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-mermaid-2 .node .label{text-align:center;}#mermaid-mermaid-2 .node.clickable{cursor:pointer;}#mermaid-mermaid-2 .arrowheadPath{fill:#333333;}#mermaid-mermaid-2 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-mermaid-2 .flowchart-link{stroke:#333333;fill:none;}#mermaid-mermaid-2 .edgeLabel{background-color:#e8e8e8;text-align:center;}#mermaid-mermaid-2 .edgeLabel rect{opacity:0.5;background-color:#e8e8e8;fill:#e8e8e8;}#mermaid-mermaid-2 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-mermaid-2 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-mermaid-2 .cluster text{fill:#333;}#mermaid-mermaid-2 .cluster span,#mermaid-mermaid-2 p{color:#333;}#mermaid-mermaid-2 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-mermaid-2 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-mermaid-2 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}

已有音频

文本转语音

准备人物图片

获取演说模板列表

选择avatar\_preset\_id

音频来源

上传音频URL

获取语音模板

获取音效模板

配置speak参数

调用演说接口

查询任务状态

获取视频URL

### 方案C：广告视频

#mermaid-mermaid-3{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-mermaid-3 .error-icon{fill:#552222;}#mermaid-mermaid-3 .error-text{fill:#552222;stroke:#552222;}#mermaid-mermaid-3 .edge-thickness-normal{stroke-width:2px;}#mermaid-mermaid-3 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-mermaid-3 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-mermaid-3 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-mermaid-3 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-mermaid-3 .marker{fill:#333333;stroke:#333333;}#mermaid-mermaid-3 .marker.cross{stroke:#333333;}#mermaid-mermaid-3 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-mermaid-3 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-mermaid-3 .cluster-label text{fill:#333;}#mermaid-mermaid-3 .cluster-label span,#mermaid-mermaid-3 p{color:#333;}#mermaid-mermaid-3 .label text,#mermaid-mermaid-3 span,#mermaid-mermaid-3 p{fill:#333;color:#333;}#mermaid-mermaid-3 .node rect,#mermaid-mermaid-3 .node circle,#mermaid-mermaid-3 .node ellipse,#mermaid-mermaid-3 .node polygon,#mermaid-mermaid-3 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-mermaid-3 .flowchart-label text{text-anchor:middle;}#mermaid-mermaid-3 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-mermaid-3 .node .label{text-align:center;}#mermaid-mermaid-3 .node.clickable{cursor:pointer;}#mermaid-mermaid-3 .arrowheadPath{fill:#333333;}#mermaid-mermaid-3 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-mermaid-3 .flowchart-link{stroke:#333333;fill:none;}#mermaid-mermaid-3 .edgeLabel{background-color:#e8e8e8;text-align:center;}#mermaid-mermaid-3 .edgeLabel rect{opacity:0.5;background-color:#e8e8e8;fill:#e8e8e8;}#mermaid-mermaid-3 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-mermaid-3 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-mermaid-3 .cluster text{fill:#333;}#mermaid-mermaid-3 .cluster span,#mermaid-mermaid-3 p{color:#333;}#mermaid-mermaid-3 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-mermaid-3 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-mermaid-3 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}

准备产品图片

访问官网获取广告模板

选择product\_placement\_sample\_id

调用广告接口

查询任务状态

获取视频URL

* * *

## 💰 成本考虑

| 功能 | 相对成本 | 建议使用场景 |
| --- | --- | --- |
| 基础视频 (lite) | 1x | 测试、简单动画 |
| 基础视频 (standard) | 2x | 正式内容、高质量需求 |
| 基础视频 (turbo) | 1.4x | 快速出图、时间紧急 |
| 演说视频 | 10x | 重要的说话视频 |
| 广告视频 | 2.6x | 商业推广 |

* * *

## 🎨 模板获取策略

### 1\. 动作模板 (Motion)

```
GET {{BASE_URL}}/higgsfield/tpl/motions?size=30&search=关键词
```

先浏览所有可用模板

根据想要的动作效果搜索

记录合适的 `motion_id`

### 2\. 演说模板 (Avatar)

```
GET {{BASE_URL}}/higgsfield/tpl/avatar-presets?size=30
```

选择合适的人物形象

考虑目标受众偏好

记录 `avatar_preset_id`

### 3\. 语音和音效模板

```
GET {{BASE_URL}}/higgsfield/tpl/voices
GET {{BASE_URL}}/higgsfield/tpl/sounds
```

选择合适的语音风格

配置音效增强体验

* * *

## ⚡ 快速决策指南

**我有一张图片，想要...**

| 需求 | 推荐接口 | 关键参数 |
| --- | --- | --- |
| 让图片动起来 | `/generate` | motion\_id |
| 让人物说话 | `/speak` | avatar\_preset\_id + audio/speak |
| 制作产品广告 | `/ads` | product\_placement\_sample\_id |
| 快速测试效果 | `/generate` (lite) | model: "lite" |
| 高质量输出 | `/generate` (standard) | model: "standard" |
| 紧急项目 | `/generate` (turbo) | model: "turbo" |

* * *

## 🔍 常见问题

**Q: 如何选择合适的模型？**

`lite`: 测试和预览使用，成本最低

`standard`: 正式发布内容，质量最高

`turbo`: 时间紧急但要求一定质量

**Q: 演说视频什么时候用音频文件，什么时候用文本转语音？**

有专业录音设备 → 上传音频文件

需要快速生成 → 使用文本转语音

需要特定语音风格 → 选择对应的voice\_id

**Q: 广告视频模板在哪里找？**

访问 [https://higgsfield.ai/ads](https://higgsfield.ai/ads)

选择合适的广告效果

记录模板ID用于API调用

**Q: 如何控制视频质量和文件大小？**

通过 `width` 和 `height` 参数调整分辨率

选择合适的模型类型平衡质量和成本