ComfyUI-Higgsfield-Direct
Direct Higgsfield API integration for ComfyUI — multi-model image and video generation with Soul 2.0, Seedream 4, Kling 2.1, Seedance, and more. Use your own API key.
Nodes (4)
ComfyUI-Higgsfield-Direct
Direct Higgsfield API integration for ComfyUI — unified access to 100+ generative models through a single node pack.
No credits system, no middleman. Uses your own Higgsfield API key with transparent pricing.
Nodes
| Node | Description | |------|-------------| | Higgsfield Text-to-Image | Generate images from text prompts (Soul 2.0, Seedream 4, Reve, FLUX) | | Higgsfield Image Edit | Edit existing images with text instructions (Seedream 4 Edit) | | Higgsfield Image-to-Video | Convert images to video (Kling 2.1, Seedance, DOP) | | Higgsfield Model Info | List all available models and capabilities |
Features
- Multi-model access — Switch between Soul 2.0, Seedream 4, Reve, Kling, and more
- Reference image support — Upload reference images for style/character consistency (Soul ID)
- Resolution control — 1K, 2K, 4K output options
- Aspect ratio presets — 1:1, 2:3, 3:2, 4:3, 9:16, 16:9, 21:9
- Video generation — 5/10/15 second clips from a source image
- Auto-save — Generated images saved to ComfyUI output folder
- Hash Vault compatible — Outputs
cache_keyfor use with ComfyUI-API-Optimizer
Installation
1. Clone into ComfyUI custom_nodes
cd ComfyUI/custom_nodes
git clone https://github.com/jeremieLouvaert/ComfyUI-Higgsfield-Direct.git
2. Install dependencies
pip install -r ComfyUI-Higgsfield-Direct/requirements.txt
3. Set up API key
Get your API key at cloud.higgsfield.ai
Option A — File (recommended):
Create higgsfield_api_key.txt in your ComfyUI root directory with content:
your_api_key:your_api_secret
Option B — Environment variable:
export HF_KEY="your_api_key:your_api_secret"
Option C — Direct input on each node via the api_key field.
4. Restart ComfyUI
Nodes appear under the AKURATE/Higgsfield category.
Models
Text-to-Image
| Model | ID |
|-------|-----|
| Soul 2.0 (Photorealistic) | higgsfield-ai/soul/standard |
| Reve | reve/text-to-image |
| Seedream 4 (ByteDance) | bytedance/seedream/v4/text-to-image |
Image Edit
| Model | ID |
|-------|-----|
| Seedream 4 Edit | bytedance/seedream/v4/edit |
Image-to-Video
| Model | ID |
|-------|-----|
| DOP Preview | higgsfield-ai/dop/preview |
| Seedance Pro | bytedance/seedance/v1/pro/image-to-video |
| Kling 2.1 Pro | kling-video/v2.1/pro/image-to-video |
Pricing
Higgsfield charges per generation. Failed/NSFW requests are not charged. Check higgsfield.ai/pricing for current rates.
License
MIT
Author
Jeremie Louvaert — github.com/jeremieLouvaert