Higgsfield API Skill
A Codex skill for images and video through the paid Higgsfield API with cost estimates, a spend cap and result downloads.
- 68 ★ on the repository
- Last commit
Extended access
Why this level
- The skill spends money on a paid API using keys from the environment; the cost estimate is approximate.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/higgsfield-api-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill spends money on a paid API using keys from the environment; the cost estimate is approximate.
This is third-party code. Review the repository files before installing.
What it does
The skill connects an agent to the direct pay-as-you-go Higgsfield API. The agent takes a model by name or recommends one from the task description and cost estimate, reads current model documentation, validates the request against a JSON schema, submits the generation, polls with backoff and downloads files into the project `outputs/` directory. One profile ships ready, the Seedance 2.5 text-to-video schema; for other models the agent first checks documentation and creates a profile. Keys are read from environment variables only, resubmission after an unclear response is blocked, and state lives in `work/higgsfield/`.
Who it is for. Video makers and developers who need short clips and images from an agent terminal with spend control per run.
Good fit when
- An agent estimates the cost of three clips for an explainer and stays within budget.
- A product photo must be animated and models need a price comparison before running.
- A generation broke off and has to resume without a second charge.
- Results land in `outputs/` and move on to editing.
Not a fit when
- There are no Higgsfield Console keys or paying for generations is off the table.
- A free model run locally by the agent is enough.
- An official Higgsfield client is required: this is an independent community skill.
Example request
Use $higgsfield-api to generate a 5-second 720p Seedance 2.5 video of a tracking shot along a coastal road and show the cost estimate before submitting.Limitations
The skill is independent and not a Higgsfield product. The `HF_API_KEY_ID` and `HF_API_KEY_SECRET` keys come from Higgsfield Console and go into the agent process environment; the skill cannot issue keys. Python 3.10 or newer and the `requirements.txt` dependencies are required. The author has not validated the package with a live paid generation: tests use simulated responses. Cost estimates are approximate, and the local budget does not read the account balance or count spend from other tools.
How to disable. Delete the `higgsfield-api` folder from the skills directory (`~/.codex/skills/higgsfield-api` for Codex), remove the keys from the environment and optionally revoke them in Higgsfield Console. The `work/higgsfield/` directory can be deleted separately.
FAQ
What does it cost?
Every generation is billed at Higgsfield rates. The skill estimates the price before submitting and, when a cap is set, blocks requests that would exceed the batch budget.
Where are keys kept?
Only in the agent process environment. Do not commit them or paste them into a chat; `.env.example` lists variable names, and the script does not read `.env` itself.
Which models are supported?
A Seedance 2.5 text-to-video profile ships ready. For other models the agent reads current documentation and creates a profile before use.
What happens if the connection drops?
An uncertain submission is preserved for recovery and is not resent automatically, which protects against double charges.
Which agents does it work with?
The README describes a Codex install into `~/.codex/skills/higgsfield-api`. Other agents with `SKILL.md` support use the same folder in their own skills directory.
Discussion
No questions or reviews yet.
Related
SkillsHiggsfield skills
higgsfield-skills
Eight official Higgsfield skills: generation, Soul character, product shoots, brand kit, marketplace cards, websites, video and thumbnails
Higgsfield Prompt Skill
higgsfield-ai-prompt-skill
A skill that turns a request into prompts for the Higgsfield video service: 32 subskills for cinema, VFX, canvas. An independent project, the service is paid
Higgsfield Claude Skills: 19 skills for video and UGC ads
Higgsfield Claude Skills
19 Claude Code skills for Higgsfield: Seedance 2.0 prompts in 15 styles and generation automated through Playwright
Higgsfield CLI
higgsfield-cli
The official Higgsfield command-line tool: more than 40 models for images, video, 3D and audio and analysis of finished video from the terminal
A skill that turns an idea, a link or a screen recording into finished video: HeyGen avatar, b-roll, captions and quality checks
A set of SKILL.md skills for short-video and content production: topic, script, voice, avatar, editing, covers and motion graphics
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Higgsfield API Skill (this card) | no | 68 | |
| Higgsfield skills | yes | 1,968 | the official Higgsfield skill set; this skill uses the direct paid API, estimates price and keeps a local budget |
| Higgsfield CLI | yes | 711 | the official Higgsfield command line; here the agent validates the request schema and guards against resubmission |
README in short
The skill turns paid API work into a safe cycle: model documentation, schema validation, price estimate, submit, poll and download. Tests make no paid requests.