Skip to main content
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

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

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

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, create task reference, retrieve or cancel, and Higgsfield upstream documentation.