开发者
面向开发者的 Higgsfield API
根据 Higgsfield 的文档(核查日期:2026年10月22日),对比请求、Webhook、价格查询和数据保留方式,以及 CheaperGen 的 API。
| 功能项 | CheaperGen | Higgsfield |
|---|---|---|
| API 风格 | CheaperGen异步处理:提交任务后轮询生成状态,或接收签名 Webhook | Higgsfield异步处理:轮询状态 URL 或接收 Webhook(hf_webhook 查询参数,最多持续重试两小时);提交任务时可使用 Idempotency-Key;排队中的请求可以取消[1][2] |
| 运行前查询价格 | CheaperGen运行前可免费查询任意输入的价格(POST /quote,无需密钥) | HiggsfieldAPI 估价端点(POST /estimate/{endpoint})会返回以 Credits 和 USD 表示的费用;应用会在 Generate 按钮上显示积分费用[3][4] |
| 数据保留 | CheaperGenAPI 输出默认在 1 天后删除;可按请求设置为 1 小时后或立即删除(企业版可保留 7 天或 30 天) | HiggsfieldAPI 输出至少保留七天,之后可能会被删除[3][5] |
迁移指南
分四步从 Higgsfield 迁移
两个平台使用相同的请求格式。只需更改 URL、身份验证请求头和少数字段名称。
- 01
创建密钥
登录,在控制台创建 API 密钥并充值额度。
- 02
更改端点
向
/api/v1/run/{endpoint}发送 POST 请求,并使用Authorization: Bearer。 - 03
映射输入字段
请求体中的字段为平铺结构。每个模型的 API 页面都提供 JSON Schema。
- 04
读取结果
轮询
GET /api/v1/generations/{id},或传入webhook_url。
之前 · Higgsfield
POST api.higgsfield.ai/bytedance/seedance-2.0/text-to-video
curl --request POST \
--url https://api.higgsfield.ai/bytedance/seedance-2.0/text-to-video \
--header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
--data '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}'
# then poll GET https://api.higgsfield.ai/requests/{request_id}/status until "completed", and read video.url来源:docs.higgsfield.ai/docs/models/seedance-2/text-to-video,核查日期:2026年10月22日。
之后 · CheaperGen · Seedance 2.0
POST /api/v1/run/bytedance/seedance-2.0/text-to-video
curl -X POST https://cheapergen.com/api/v1/run/bytedance/seedance-2.0/text-to-video \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}'| 概念 | Higgsfield | CheaperGen |
|---|---|---|
| 提交 | HiggsfieldPOST /{endpoint_id} | CheaperGenPOST /api/v1/run/{endpoint} |
| 模型 | Higgsfieldbytedance/seedance-2.0/text-to-video | CheaperGenbytedance/seedance-2.0/text-to-video |
| Auth | HiggsfieldAuthorization: Key <key_id>:<key_secret> | CheaperGenAuthorization: Bearer cg_live_… |
| 输入 | Higgsfield扁平 JSON 请求正文:prompt、aspect_ratio、resolution、duration、generate_audio | CheaperGen扁平请求正文的字段 |
| Result | HiggsfieldGET /requests/{request_id}/status | CheaperGenGET /api/v1/generations/{id} |
| Finished | Higgsfieldstatus: completed | failed | nsfw | canceled | CheaperGenstatus: succeeded | failed | canceled |
| 输出 | Higgsfieldvideo.url | CheaperGenoutput.video.url |
| Webhook | Higgsfield?hf_webhook=https://…(查询参数) | CheaperGen"webhook_url": "https://…" (body) |
常见问题
Higgsfield AI API 常见问题
Higgsfield 的文档说明 `POST /{endpoint_id}` 使用 `Authorization: Key <key_id>:<key_secret>`,然后用 `GET /requests/{request_id}/status` 获取结果。在 CheaperGen 上,使用 `POST /api/v1/run/{endpoint}` 和 `Authorization: Bearer` 发送请求,然后通过 `GET /api/v1/generations/{id}` 或 Webhook 获取结果。上方的迁移指南列出了各字段的对应关系。
支持:?hf_webhook=https://…(查询参数)。CheaperGen 会在请求正文中接收 `webhook_url`,并使用 HMAC-SHA256 对每次推送进行签名(通过 `CheaperGen-Signature` 请求头)。详见 Webhook。
大体可以:修改 URL、身份验证请求头和少数字段名称即可。上方的迁移指南展示了双方使用相同请求的方式。 每个模型的 API 页面都提供其 JSON Schema。
根据其公开文档:异步处理:轮询状态 URL 或接收 Webhook(hf_webhook 查询参数,最多持续重试两小时);提交任务时可使用 Idempotency-Key;排队中的请求可以取消。CheaperGen 的 API 为异步调用——提交后轮询,或接收 Webhook;在 MCP 服务器上,生成过程最多可等待 50 秒以获取结果。
对于 5 与 CheaperGen 都提供且我们价格更低的模型,比 Higgsfield 标价 低至 68%。Higgsfield API 价格 页面列出了所有档位。
相关页面
了解更多关于 Higgsfield AI 的信息
来源——Higgsfield 公开页面,核查日期:2026年10月22日 (5)
- [1] docs.higgsfield.ai/docs/concepts/requests
- [2] docs.higgsfield.ai/docs/how-to/webhooks
- [3] docs.higgsfield.ai/docs/concepts/billing-and-retention
- [4] higgsfield.ai/creator-hub/help-center/credits/how-credits-work
- [5] docs.higgsfield.ai/docs/help/faq
Higgsfield 及其徽标是其所有者的商标,仅用于标识本页所比较的平台。CheaperGen 与 Higgsfield 无关联,也未获其认可。Higgsfield 的价格和功能信息来自其公开页面(2026年10月22日),此后可能已有变化。模型名称和商标归各自所有者所有。