# Higgsfield API (slim)

> Higgsfield's API for generating images and video from its own models (Genjutsu, Soul, Cinema Studio) and hosted ones such as Kling, Seedance and Wan. Requests are asynchronous, with polling or webhooks, and Python and TypeScript SDKs.

- Full: https://www.anchorterminal.com/tools/higgsfield.md (~7,850 tokens) · this version ~1,830 tokens · JSON https://www.anchorterminal.com/tools/higgsfield.json · canonical https://www.anchorterminal.com/tools/higgsfield
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-09

**B · 63.5/100 · rank #356 of 842 · #3 in Video generation · not agent-ready · confidence medium**


Assessment: One asynchronous API for 67 video and 17 image catalogue entries, with idempotency keys, per-second list prices public without a login, and failed or moderated jobs not charged. API inputs and outputs train Higgsfield's models unless the workspace opts out, and the docs carry no changelog. The API returns 400 at the concurrency limit, with no Retry-After.

## Facts

- Kind: HTTP API · vendor: Higgsfield Inc. · category: Video generation · legal entity: Higgsfield Inc. · provenance 77/100
- Endpoint: `https://api.higgsfield.ai` (HTTP)
- Auth: API key · pricing: Pay per use · x402: no · licence: Proprietary service under the Higgsfield API Terms of Service. The Python SDK repository is Apache-2.0 and the TypeScript SDK is MIT on npm
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The REST API at https://api.higgsfield.ai. A hosted MCP server at https://mcp.higgsfield.ai/mcp (OAuth) belongs to the consumer product and was not graded
- Catalogue: 84 entries per the docs, 67 video in 22 families and 17 image. Higgsfield's own Genjutsu, Cinema Studio 4.0 and Soul, plus Kling, Seedance, Wan, Happy Horse, MiniMax, LTX, PixVerse and Grok
- Request lifecycle: POST to a model endpoint returns `request_id`, `status_url` and `cancel_url`. States are `queued`, `in_progress`, `completed`, `failed`, `nsfw` and `canceled`
- Max clip length: Up to 30 seconds on Seedance 2.5, Wan 3.0, Cinema Studio 4.0 and Genjutsu, 15 seconds on Kling 3.0, per the console's model cards
- Resolution: 480p to 1080p on most models, 2K on MiniMax H3, 4K on Kling 3.0 4K, Seedance 2.0 and LTX 2.5 Fast
- Audio: Optional generated audio on Kling 3.0, Seedance 2.5, Wan 3.0, LTX 2.5 and others, per the model cards
- Rate limits: Concurrency by funds added in the past 28 days. 2 for a new account, 10 from $25, 20 from $100, 40 from $1,000. Over the limit returns 400, with no `Retry-After`
- Webhooks: `hf_webhook` query parameter on submit. Retries on network failure and 5xx for up to two hours, duplicates possible, no signature documented
- Billing: Prepaid balance, credits expire after one year. `failed` and `nsfw` requests aren't charged. Invoicing under a committed-use contract
- Data use: API inputs and outputs may train Higgsfield's models unless the workspace turns the setting off. Content sent to a partner model goes to that third party
- Retention: Media files kept at least seven days. Request records kept while the account is active. Zero retention only under an enterprise addendum
- SDKs: Python `higgsfield-client` 0.2.0 (Apache-2.0 repository) and TypeScript `@higgsfield/client` 0.2.6 (MIT), both released 17 September 2026
- Status: status.higgsfield.ai on Instatus, two components (API, Cloud Console), no notices from August to October 2026
- Prices: Kling 3.0, list price from $0.084 per second of video; Seedance 2.5, list price from $0.206 per second of video; Wan 3.0 Prime, list price from $0.068 per second of video; Genjutsu 480p, list price $0.318 per second of video; Kling 2.5, list price from $0.042 per second of video

- Scores: Reliability 85, Performance pending, Schema & documentation 69, Agent ergonomics 77, Security & auth 48, Payments & pricing 20, Task success pending, Maintenance & community 75, Transparency & trust 61 · total over the 7 assessed categories
- Why: Reliability, Hosted reading. · Schema & documentation, `/docs/openapi.json` is public OpenAPI 3.1 but covers 8 paths, and llms.txt calls it supplementary. · Agent ergonomics, Submissions return a small JSON handle, results are URLs, and webhooks replace polling (20 of 25). · Security & auth, Hosted reading. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, The docs sitemap shows pages changed on 7 October 2026, and the SDKs were last released on 17 September 2026 (30). · Transparency & trust, Closed service with API terms dated 2 September 2026 that are specific on licence, resale and outputs.
- Sources: 19, open questions: 8, both in the full twin
- Capabilities: video.generate, video.image-to-video, video.edit, video.audio, image.generate, image.edit
- JSON: https://www.anchorterminal.com/api/v1/tools/higgsfield.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/higgsfield.svg` or a link to https://www.anchorterminal.com/tools/higgsfield from a page on higgsfield.ai or one of its subdomains, or the README of github.com/higgsfield-ai/higgsfield-client, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Send `Authorization: Key <key_id>:<key_secret>` to https://api.higgsfield.ai. A Bearer token is rejected
2. Send a fresh `Idempotency-Key` with every generation. After a timeout or 5xx, repeat the same request with the same key, then read `status_url`
3. Treat a 400 whose `detail` mentions concurrent requests as a limit, not a bad request. Wait for a running job to finish before submitting more
4. Poll `status_url` from 2 seconds up to 10 with jitter, and stop on `completed`, `failed`, `nsfw` or `canceled`
5. Download output within seven days. Media files may be deleted after that
6. Read the model's own docs page for its schema. The OpenAPI file lists only a few models

## Connect

```bash
pip install higgsfield-client
```

```bash
curl --request POST \
  --url https://api.higgsfield.ai/higgsfield/genjutsu/motion-transfer/v1.0 \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{"video_url": "https://example.com/input.mp4", "image_urls": ["https://example.com/input.jpg"]}'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/higgsfield

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| fal video models | B | 68.9 | video.generate, video.image-to-video, video.edit, video.audio | https://www.anchorterminal.com/tools/fal-video.min.md |
| Alibaba Wan (Model Studio) | B | 65.1 | video.generate, video.image-to-video, video.edit, video.audio | https://www.anchorterminal.com/tools/alibaba-wan.min.md |
| Replicate video models | B | 62.1 | video.generate, video.image-to-video, video.audio, video.edit | https://www.anchorterminal.com/tools/replicate-video.min.md |
| Runway API | C | 60.8 | video.generate, video.image-to-video, video.edit, video.audio | https://www.anchorterminal.com/tools/runway.min.md |
| MiniMax Video API | C | 60 | video.generate, video.image-to-video, video.edit, video.audio | https://www.anchorterminal.com/tools/minimax-video.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)