> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gengen.farm/llms.txt
> Use this file to discover all available pages before exploring further.

# Higgsfield video generation

> Independent Higgsfield Seedance 2.0 and 2.5 integration, parameters, media inputs and task lifecycle.

Higgsfield is a separate provider. Select `higgsfield-seedance-2.0` or
`higgsfield-seedance-2.5` in the top-level `model` field. Use the shared
`/api/gengen/v1/contents/generations/tasks` API and your GENGEN API key.

## Models and controls

| Control | Seedance 2.0 | Seedance 2.5 |
| - | - | - |
| Model ID | `higgsfield-seedance-2.0` | `higgsfield-seedance-2.5` |
| Duration | 4–15 integer seconds; default 5 | 4–30 integer seconds; default 5; omit for editing |
| Resolution | `480p`, `720p`, `1080p`, `4k` | `480p`, `720p` |
| Default resolution | `720p` | `720p` |
| Audio | `controls.generateAudio`, default `true` | `controls.generateAudio`, default `true` |
| Bitrate | Not supported | `controls.bitrateMode`: `standard` or `high`; upstream default `high` |
| Reference images / videos / audio | 9 / 3 / 3 | 30 / 10 / 10; at most 50 total |

Text and reference workflows accept `controls.ratio`: `16:9` (default), `4:3`,
`1:1`, `3:4`, `9:16`, or `21:9`. Frame, edit and extend workflows follow input
framing: omit the ratio or use `adaptive`. `controls.outputFormat`, watermark,
seed and disabling content filtering are not supported by this integration.
The current Higgsfield schema does not expose the upstream BytePlus MOV option.

## Workflows and media

| `mode` | `assets` | Availability |
| - | - | - |
| `text_to_video` | None; prompt required | Both models |
| `image_first_frame` | `firstFrameImage`, optional `lastFrameImage` | Both models |
| `image_first_last_frame` | `firstFrameImage` and `lastFrameImage` | Both models |
| `multimodal_reference` | `referenceImages`, `referenceVideos`, `referenceAudios` arrays | Both models |
| `video_modify` | `sourceVideo`, optional reference arrays; prompt required | 2.5 only |
| `video_extend` | `sourceVideo`, optional reference arrays; prompt required | 2.5 only |

Upload media or provide publicly reachable HTTPS URLs. No Higgsfield character
library registration is required by these endpoints. `asset://` IDs from the
BytePlus asset library are not accepted; use the original accessible media URL.
You must have permission to use the supplied media. Provider moderation still applies.

For 2.0 reference generation, supply an image or video reference; audio alone is
insufficient. For 2.5, audio-only references are supported. The source video counts
toward the 10-video limit for edit/extend, leaving at most 9 additional videos.
Higgsfield describes separate normalization of reference video and audio duration
to at most 15 seconds for 2.0 and 30 seconds for 2.5.

## Example

```json theme={"dark"}
{
  "model": "higgsfield-seedance-2.5",
  "mode": "multimodal_reference",
  "prompt": "Keep the character consistent during a slow camera movement.",
  "assets": {
    "referenceImages": ["https://example.com/character.jpg"]
  },
  "controls": {
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generateAudio": true,
    "bitrateMode": "high"
  }
}
```

Advanced native bitrate overrides can use `providerOptions.higgsfield.bitrate_mode`;
`controls.bitrateMode` takes precedence. Do not send a `seedance` compatibility object.

## Task lifecycle

Tasks use independent `higgsfield20:<uuid>` or `higgsfield25:<uuid>` IDs. Poll the shared task endpoint and read `outputs.videos`.
Statuses map to `queued`, `running`, `succeeded`, `failed`, and `cancelled`.
Provider moderation failures map to `failed`. Internal provider URLs, credentials,
and raw billing fields are not exposed.

GENGEN task history lists locally recorded tasks for the authenticated caller;
Higgsfield has no documented remote list operation. DELETE requests cancellation;
only queued upstream tasks can be canceled. A cancellation must be explicitly
confirmed before a reservation can be released. It does not delete a finished video.

GENGEN stores completed videos and returns signed download URLs valid for seven days.
Retrieve the task again to refresh an expired download URL.

## Billing

GENGEN reserves an estimated amount before submission. Successful generation is
charged using measured output dimensions and duration. Video references also
contribute billable duration; image and audio references do not. Failed or confirmed
canceled tasks release the reservation. Repeated polling does not charge twice.
Background reconciliation continues when the Playground is closed.

Source and reference videos must be 2–15 seconds each for Seedance 2.0, or
2–30 seconds each with a combined maximum of 30 seconds for Seedance 2.5.
GENGEN rejects longer inputs before submission instead of relying on upstream trimming.

If submission times out, its acceptance may be uncertain. Do not automatically
submit a new task; contact support to reconcile the original reservation.

[Open the Playground](https://gengen.farm/playground?model=higgsfield-seedance-2.5),
[create task reference](/api-reference/higgsfield/video-generation/create-task),
[retrieve or cancel](/api-reference/higgsfield/video-generation/retrieve-task),
and [Higgsfield upstream documentation](https://docs.higgsfield.ai/docs/models/video-generation).