# Higgsfield 视频模型

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

### 📋 概述

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

### 🎯 接口使用场景

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

**适用场景：**

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

创建短视频内容

制作动画效果

社交媒体内容创作

**何时使用：**

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

✅ 需要创建循环动画

✅ 制作产品展示视频

✅ 创建艺术动画作品

**不适用：**

❌ 需要人物说话的视频

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

---

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

**适用场景：**

数字人说话视频

教育培训内容

客服视频

个人vlog

**何时使用：**

✅ 需要人物开口说话

✅ 制作教学视频

✅ 客服自动回复视频

✅ 虚拟主播内容

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

**音频来源选择：**

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

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

---

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

**适用场景：**

产品广告制作

电商推广视频

品牌宣传

营销活动

**何时使用：**

✅ 产品需要专业广告效果

✅ 电商平台产品推广

✅ 品牌营销活动

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

**注意：**

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

模板需要从官网获取

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

---

### 🔄 标准工作流程

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

#### 方案B：演说视频

#### 方案C：广告视频

---

### 💰 成本考虑

| 功能 | 相对成本 | 建议使用场景 |
| --- | --- | --- |
| 基础视频 (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>

选择合适的广告效果

记录模板ID用于API调用

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

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

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