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
否
是
准备图片
获取动作模板列表
选择合适的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
已有音频
文本转语音
准备人物图片
获取演说模板列表
选择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
准备产品图片
访问官网获取广告模板
选择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: 广告视频模板在哪里找？
选择合适的广告效果
记录模板ID用于API调用
Q: 如何控制视频质量和文件大小？
通过 width 和 height 参数调整分辨率
选择合适的模型类型平衡质量和成本