Higgsfield API:能做什么、怎么开通
更新于 2026-11-21
Higgsfield 最出名的是 higgsfield.ai 上给创作者用的网页版。API 是另一个产品,单独计费:网站上的订阅、积分和 Unlimited 权益都不能用在 API 上,API 用的是自己的美元余额。
Higgsfield API 怎么用
自助开通。在 open.higgsfield.ai 控制台以个人或公司身份建 API 账号,登记付款方式,给余额充值(最低 $5),再生成 Key;完整的 Key 只显示一次。只有月度承诺量或定制量价才需要找销售。
请求发到 api.higgsfield.ai,请求头是 Authorization: Key KEY_ID:KEY_SECRET;Higgsfield 要求只从后端调用,不要在浏览器或手机端代码里调。任务是异步的:提交后轮询状态,或者接收按 Standard Webhooks 规范签名的回调,失败会重试最多两小时。生成的文件保留 7 天。
每把 Key 起步 20 个并发请求,队列满时返回 429 并带 Retry-After 头。Higgsfield 提供官方 SDK:Python 是 higgsfield-client,Node / TypeScript 是 @higgsfield/client。
Higgsfield API 怎么计费
从美元余额里按次扣费,没有订阅,也不按席位收:视频按秒计价,图片按张计价,单价随模型和参数变化。各模型的价目表在 higgsfield.ai/higgsfield-api。
只对成功的请求收费。结果是 failed 或 nsfw 的请求不收费,排队中、开始处理前取消的请求会退款。充进去的余额一年后过期。
Higgsfield API 有哪些模型
取自 higgsfield.ai/higgsfield-api 的价目目录和 docs.higgsfield.ai,2026 年 11 月 21 日核对。那一页的常见问题里提到了 Veo 和 GPT Image,但价目目录里没有。
| 类型 | Higgsfield API 目录里有 | 目录里没有 |
|---|---|---|
| 视频 | Seedance 2.5、2.0;可灵 4.0、4.0 Flash、3.0、O3、O1、2.6、2.5;MiniMax H3 Highspeed 和 Lite、海螺 2.3;万相 3.0、3.0 Prime、2.7、2.6;Grok Imagine Video 1.5;LTX 2.5 Fast 和 Pro;Happy Horse 1.1、1.0;PixVerse 6;Higgsfield 自家的 Genjutsu、Genjutsu Light、Cinema Studio 4.0 | Veo 3.1、Gemini Omni |
| 图像 | Kling Image 4.0、Seedream 5.0 Pro、Grok Imagine 2.0、Qwen Image 3、Z-Image Turbo、Ideogram 4.0、Recraft 4.1;Higgsfield 自家的 Soul 2、Soul Standard、Marketing Studio Image | Nano Banana、GPT Image |
| 语言和音频 | 没有列出 | Claude、GPT、Gemini 等语言模型 |
如果还要 Veo、Gemini Omni 或语言模型,用同一把 Key
发布本页的 APIMODELS 是一个多模型 API:一把 Key 能调 Seedance、可灵、万相、MiniMax H3、Grok Imagine、LTX 视频,还有 Veo 3.1、Gemini Omni,GPT Image、Nano Banana 图像,以及通过兼容 OpenAI 和 Anthropic 的接口调用 Claude、GPT、Gemini 等语言模型。从预付美元余额扣费(最低充值 $10),生成失败不扣费。
APIMODELS 没有 Higgsfield 自家的模型,比如 Soul、Cinema Studio、Genjutsu,要用这些就用 Higgsfield。两家 API 的逐项对比见「Higgsfield API 替代方案」那一页。
出处(2026-11-21 核对)
| 内容 | 出处 |
|---|---|
| 模型目录、按次付费、20 个并发、上线优惠 | higgsfield.ai/higgsfield-api |
| 自助开通、最低充值 $5、API 与网站订阅分开计费 | higgsfield.ai/creator-hub/help-center/integrations/what-is-the-higgsfield-api |
| 鉴权请求头、只能服务端调用 | docs.higgsfield.ai/docs/authentication.md |
| 哪些收费、余额过期、文件保留 7 天 | docs.higgsfield.ai/docs/concepts/billing-and-retention.md |
| 回调、SDK、限流、模型数量 | docs.higgsfield.ai(how-to/webhooks、how-to/sdk、concepts/rate-limits、models) |
调用示例
cURL
# On APIMODELS: the same request shape for Seedance, Kling, Veo 3.1 and Gemini Omni
curl -X POST https://api.apimodels.app/v1/video/generations \
-H "Authorization: Bearer $APIMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "A paper boat drifts down a rain-soaked street, close-up, soft city sounds",
"resolution": "720p",
"duration": 8
}'Python
import requests
H = {"Authorization": "Bearer YOUR_APIMODELS_KEY"}
for model in ["seedance-2.5", "kling-4.0", "veo-3.1-fast-fhd", "gemini-omni-1.2-flash"]:
r = requests.post("https://api.apimodels.app/v1/video/generations", headers=H, json={
"model": model,
"prompt": "A paper boat drifts down a rain-soaked street, close-up",
})
print(model, r.json()) # poll GET /v1/video/generations?task_id=...常见问题
Higgsfield 有 API 吗?
有。Open Higgsfield 是公开、可自助开通的开发者 API,控制台在 open.higgsfield.ai,文档在 docs.higgsfield.ai。它提供 84 个图像和视频模型,包括 Seedance、可灵、万相、MiniMax H3 和 Higgsfield 自家的 Soul、Cinema Studio,和 higgsfield.ai 网站的订阅分开计费。
Higgsfield API 怎么收费?
按次收费,从预付的美元余额里扣:视频按秒、图片按张,每个模型单独定价,不用订阅。最低充值 $5,failed 和 nsfw 的请求不收费,充进去的余额一年后过期。各模型价目表在 higgsfield.ai/higgsfield-api。
Higgsfield API 免费吗?
没有免费档,要先充值再生成。按 2026 年 11 月 21 日 higgsfield.ai/higgsfield-api 的说法,上线期间验证企业邮箱并绑卡的账号送 $15 余额;现行条件以那一页为准。
Higgsfield API Key 怎么拿?
在 open.higgsfield.ai 以个人或公司身份建 API 账号,登记付款方式,至少充值 $5,然后在控制台生成 Key 并马上复制,完整的 Key 只显示一次。每份凭证是一个 Key ID 加一个密钥,一起放进请求头 Authorization: Key KEY_ID:KEY_SECRET。
Higgsfield API 和网站订阅是一回事吗?
不是。Higgsfield 把两者当作两个独立产品、分开计费。网站的订阅、积分和 Unlimited 只在 higgsfield.ai 上有效,API 用的是自己的美元余额。Higgsfield 的 MCP 服务和 ChatGPT 应用扣的是网站积分,不是 API 余额。
