Skip to main content
POST
Create a Higgsfield video task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required
Available options:
higgsfield-seedance-2.0,
higgsfield-seedance-2.5
mode
enum<string>

Inferred from media when omitted. Editing and extension require 2.5.

Available options:
text_to_video,
image_first_frame,
image_first_last_frame,
multimodal_reference,
video_modify,
video_extend
prompt
string

Required and nonblank for text, edit and extend workflows.

assets
object

2.0 limits: 9 images, 3 videos, 3 audio files; requires an image or video reference. 2.5: 30 images, 10 videos (including source), 10 audio files, maximum 50 total; supports audio-only reference.

controls
object
providerOptions
object

Response

Normalized GENGEN task. Poll until terminal completion.

id
string
required
model
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed,
cancelled
outputs
object
required
failureReason
string