--- name: seedance description: | This skill should be used when the user names Seedance or Higgsfield for a video, or asks for a multi-shot cinematic clip, an image-to-video shot anchored on a first and/or last frame, a clip with spoken dialogue or lip-synced to an audio file, or an edit or extension of an existing clip: "make a Seedance video", "generate this on Higgsfield", "animate this photo into a 15s multi-shot clip", "make her speak this voice line", "extend this clip". Video only. Image generation, ads, and avatar or identity training are out of scope — route images elsewhere. --- # Seedance Video on Higgsfield Draft a Seedance prompt from the user's intent, submit it through the `higgsfield` CLI, and hand back the result URL. The prompt is where the quality comes from; the CLI part is mechanical. ## Prerequisite — the CLI and a session The `higgsfield` CLI is a prerequisite, not something this plugin ships. 1. `command -v higgsfield` — when absent, install it with the vendor's installer, `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh`. 2. `higgsfield account status` — when it reports `Session expired` or `Not authenticated`, the login is interactive: ask the user to run `! higgsfield auth login` and wait for them to confirm before going on. Every other command in this skill fails with the same two messages until the session is valid, so check once up front rather than per command. ## The model — Seedance 2.5 only Use the newest Seedance release and nothing older — currently `seedance_2_5`. When the user asks for something its schema does not accept, say so rather than switching to an older model. Its accepted durations, aspect ratios, resolutions, parameters, and media limits move with Higgsfield releases, so no figures are given here. - `higgsfield model list --video` — take the Seedance with the highest version listed. When that is no longer `seedance_2_5`, use it instead and read its schema before relying on anything below. - `higgsfield model get seedance_2_5 --json` — the schema: modes, durations, aspect ratios, resolutions, parameters with defaults, and the media roles each input slot accepts. Pass only what the schema declares; leave the rest to its defaults. ## Modes `--mode` decides what the job is and which inputs it takes; pass it on every job rather than relying on the schema's default: | Mode | Use for | |---|---| | `t2v` | prompt only — accepts no media | | `omni_reference` | any job with an input: a first or last frame, reference images, a reference clip, or audio | | `video_edit` | changing an existing clip | | `video_extension` | continuing an existing clip | For the two clip modes, read `model get` for the role the source clip takes. ## Inputs — images, video, audio Media flags take a local path (the CLI uploads it) or a UUID (an upload id from `higgsfield upload create`, or a previous job id — the CLI tells the two apart). Any of them needs `--mode omni_reference` or a clip mode. | Flag | What it anchors | |---|---| | `--image` | a reference image — character, prop, location, style; repeatable | | `--start-image` | the first frame | | `--end-image` | the last frame, for a transition between two frames | | `--video` | a reference clip; for the clip modes, the source clip goes in the role `model get` declares | | `--audio` | a voice or soundtrack to sync to | `model get` is the authority when a role is rejected (`Unknown media role`). ## Sound and speech Seedance generates sound in the same pass as the picture while `--generate_audio` is on: ambience, effects, and any dialogue the prompt quotes, lip-synced to the speaker. Read its default from `model get`, and pass it explicitly when the brief depends on it — on for dialogue, off for a silent clip. Write the lines into the prompt for speech the model voices itself. Pass `--audio` only when the user supplies the recording to sync to. ## Drafting the prompt Read [references/prompting.md](references/prompting.md) before writing the prompt. It carries the labelled layout Seedance responds to — style, cast, blocking, shots, locks, dialogue, audio — and what changes when a start frame or reference images are attached. Show the user the drafted prompt before submitting when their brief left the shot structure, duration, or aspect ratio open; submit directly when they already fixed those. ## Submitting A generation spends the user's Higgsfield credits. The user asking for the video is the go-ahead for one run; before a batch or a retry loop, say how many runs and ask. `higgsfield generate cost seedance_2_5 [same flags] < prompt.txt` estimates credits without submitting — use it when the user asks about cost. While a clip is still being iterated, make that run a draft at the lowest resolution the schema accepts, say so, and ask before rendering the final take at the resolution the user wants — the final render is a second paid run. Seedance prompts run to many lines and carry quotes, so write the prompt to a file and pipe it in rather than quoting it on the command line: ```bash higgsfield generate create seedance_2_5 --mode omni_reference \ --start-image ./first.png --aspect_ratio --duration \ --resolution --wait --wait-timeout 20m < prompt.txt ``` Flags other than media and `--wait*` pass straight through to the model schema as `-- `. `--wait` blocks until the job finishes and prints the result URL; long clips need a longer `--wait-timeout` than the default. A job started without `--wait` can be rejoined with `higgsfield generate wait `; `generate list` and `generate get ` show past jobs. Add `--json` only when a later step parses the output. ## Delivering Give the result URL and one line: mode, duration, aspect ratio, resolution. Keep job ids and raw JSON out of the reply unless the user asks for them. ## When it fails | Message | Meaning and next move | |---|---| | `Session expired` / `Not authenticated` / credentials for another environment | the user runs `! higgsfield auth login` | | `Missing required params: prompt` | the prompt did not reach the CLI — check the stdin redirect | | `Invalid values: = (allowed: …)` | pick from the allowed list it prints | | `Unknown params: ` | the schema does not declare that flag — re-read `model get` | | a media input rejected while `--mode t2v` is set | the job has an input — resubmit with `--mode omni_reference` | | a reference-count or reference-combination constraint | the schema's media limits — follow the constraint message: drop references, or add the input it names | | job ends `failed`, `nsfw`, or `ip_detected` | content policy or a server-side failure — rephrase; real public figures, sexual content, and trademarked characters are rejected | | timeout while waiting | the job is still running — `generate wait `, or raise `--wait-timeout` | | HTTP 429 | rate limited — back off before retrying | | an HTML body mentioning a captcha | the server's bot check fired — wait about half a minute and retry once | The server may also return non-fatal `adjustments` (a value coerced to the nearest accepted one); mention them to the user when they change what was asked for.