How it works
Modes
t2v- Text to video. Prompt only, no files.
omni_reference- Prompt plus at least one file: start image, end image, reference images, videos or audio.
video_edit- Change an existing video. Exactly one reference video.
video_extension- Continue a video forward or backward. At least one reference video and extension_mode.
Limits
- Duration: whole seconds from 4 to 30.
- Resolution: 480p, 720p or 1080p. Aspect ratio: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
- Up to 50 files in total, of which up to 30 images (start and end image included).
- Up to 2 videos are made at the same time; the rest wait in line.
- A video usually takes 3 to 9 minutes.
Price
You pay Higgsfield in credits, as usual. On top, Apify charges $4 per 1,000 credits the video used, only when the video is delivered. Failed or timed-out videos are not charged by us.
Higgsfield burns unused subscription credits when you change plans.
Errors
apify_auth_failed- The request did not come from a running copy of this Actor.
higgsfield_not_connected- No Higgsfield account is connected. Run the Actor in connect mode.
higgsfield_reconnect_required- Higgsfield signed you out. Run the Actor in connect mode again.
insufficient_credits- Your Higgsfield workspace does not have enough credits. The error says how many are needed and how many you have.
invalid_params- A parameter is not allowed for the chosen mode. The message says which one.
input_download_failed- One of your file links could not be downloaded. It must be a public http(s) link to an image, video or audio file.
higgsfield_rejected- Higgsfield refused the request. Its own message is included; a common reason is a plan without Seedance 2.5.
generation_failed- Higgsfield could not finish the video. You are not charged by us.
generation_timeout- The video took too long. Check your history on higgsfield.ai; you are not charged by us.
submit_interrupted- Something went wrong after the request was sent to Higgsfield, so the video may still appear in your higgsfield.ai history. Check there before trying again; you are not charged by us.
too_many_queued_generations- Too many videos are waiting. Wait for some to finish.
not_found- No such generation for your account.
idempotency_conflict- The same request id was used earlier with different parameters.