🎬 Higgsfield AI 调研报告

Higgsfield AI 是一个 AI-native 创意套件平台，核心定位是「一站式 AI 内容创作」——聚合了市面上最前沿的闭源 AI 模型（视频/图片/音频/3D），通过统一的 API + CLI + Web UI 提供服务。

核心定位

• 不训练模型 — 是一个 模型聚合/编排平台，接入第三方模型（ByteDance Seedance/Seedream、Google Veo、Kling、Wan、Minimax、FLUX.2、GPT Image 2、Grok 等）
• 不部署在你自己的 GPU 上 — 纯 SaaS，所有推理在 Higgsfield 的云上运行
• 面向创作者和开发者 — Web UI（Cinema Studio / Supercomputer）+ CLI + Python/JS SDK + MCP Server
• 核心价值 — 一个 API Key 调用 55+ 模型，统一计费（credits），统一异步任务管理

VIDEO 视频模型 (22)

IMAGE 图片模型 (23)

3D 3D 模型 (5)

AUDIO 音频模型 (5)

采用 Credit 积分制，按年付有折扣（当前 30% OFF 促销）。不同模型消耗不同 credit。

CLI (@higgsfield/cli v1.1.20)

Go 编译的二进制，支持 macOS/Linux/Windows，通过 npm / Homebrew / curl 安装。

# 安装
npm install -g @higgsfield/cli
# 或
brew install higgsfield-ai/tap/higgsfield
# 或
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

# 认证
higgsfield auth login

# 生成图片
higgsfield generate create nano_banana_2 \
  --prompt "a quiet beach at sunrise" \
  --aspect_ratio 16:9 --resolution 2k --wait

# 生成视频 (Seedance 2.0)
higgsfield generate create seedance_2_0 \
  --prompt "drone shot over a mountain valley" \
  --duration 5 --resolution 4k --mode std --genre noir --wait

# 列出模型
higgsfield model list

# 病毒度预测
higgsfield generate create brain_activity --video ./ad.mp4 --wait

核心命令

Python SDK (higgsfield-client)

pip install higgsfield-client

import higgsfield_client

# 同步：提交并等待
result = higgsfield_client.subscribe(
    'bytedance/seedream/v4/text-to-image',
    arguments={
        'prompt': 'A serene lake at sunset',
        'resolution': '2K',
        'aspect_ratio': '16:9',
    }
)
print(result['images'][0]['url'])

# 异步：提交后轮询
controller = higgsfield_client.submit(
    'bytedance/seedream/v4/text-to-image',
    arguments={...},
    webhook_url='https://example.com/webhook'
)
for status in controller.poll_request_status():
    print(type(status).__name__)  # Queued/InProgress/Completed

result = controller.get()

JS/TS SDK (@higgsfield/client)

npm install @higgsfield/client

import { higgsfield, config } from '@higgsfield/client/v2';

config({ credentials: 'KEY_ID:KEY_SECRET' });

const jobSet = await higgsfield.subscribe('flux-pro/kontext/max/text-to-image', {
  input: { aspect_ratio: '9:16', prompt: 'A beautiful sunset', seed: 1234 },
  withPolling: true,
});

console.log(jobSet.jobs[0].results?.raw.url);

Higgsfield 提供 MCP Server（Model Context Protocol），可以将 Claude/Cursor 等 AI 编辑器变成创意引擎。

CLI 本身就是 Agent 友好的

• 所有命令支持 --json 输出
• --wait 阻塞等待结果，--wait-timeout 控制超时
• 任务 ID 可查询 (generate get)、等待 (generate wait)、取消 (cancel)
• Webhook 回调支持异步通知

任务生命周期

提交任务 → Queued → InProgress → Completed/Failed/NSFW/Cancelled
                                    ↓
                              返回 images/video URL

认证

• Key 格式： KEY_ID:KEY_SECRET
• Header： Authorization: Key KEY_ID:KEY_SECRET
• 获取： 从 cloud.higgsfield.ai 获取
• 环境变量： HF_KEY 或 HF_API_KEY + HF_API_SECRET

核心端点

状态值

可接入点

社区 Skill 生态（Claude Code Skills）

Higgsfield 已有活跃的 Claude Code Skill 社区：