Werydance 2.0 video generator (almighty-ready)

Generate Werydance 2.0 videos on WeryAI with one skill for text-to-video, image-to-video, first-frame/last-frame transition video, multi-image storyboard video, and almighty mixed-reference video generation.
Animate and transform scenes from single images, storyboard frames, or mixed references while keeping subject and motion continuity.

Dependencies: scripts/video_gen.js at the skill package root (alongside SKILL.md) + WERYAI_API_KEY + Node.js 18+. No other Cursor skills are required.

• - text-only generation
• single-image animation
• multi-image storyboard generation
• first-frame/last-frame compatibility aliases
• almighty mixed references (images + videos + audios + prompt)

Runtime secret: only WERYAI_API_KEY.

Core upgrade

This skill now supports four input modalities for richer control:

• - Image reference: composition, character, and detail lock
• Video reference: camera language, action rhythm, effect imitation
• Audio reference: mood and timing guidance
• Text prompt: intent and constraints

Smart routing policy:

• - If payload includes videos or audios, route to POST /v1/generation/almighty-reference-to-video.
• Otherwise keep legacy routing (text-to-video, image-to-video, multi-image-to-video).

Prerequisites

• - WERYAI_API_KEY must be set.
• Node.js 18+.
• Prefer public https URLs for media.
• Local files are supported and auto-uploaded by this skill via POST /v1/generation/upload-file.

CODEBLOCK0

Quick checks

CODEBLOCK1

Modes and input shapes

Compatibility aliases still supported:

• - first_frame + last_frame -> normalized to ordered INLINECODE37
• INLINECODE38 -> normalized to ordered INLINECODE39

Almighty constraints

Almighty validations in this skill:

• - prompt max 500 chars
• INLINECODE41 <= 9
• INLINECODE42 <= 3
• INLINECODE43 <= 3
• mixed file total (images + videos + audios) <= 12
• at least one of images or INLINECODE46
• INLINECODE47 must be 5-15 seconds
• INLINECODE48 must be 1-4

Notes:

• - Backend enforces media-duration constraints for reference clips.
• Per current OpenAPI contract, almighty duration floor is 5s.

Local upload behavior

Supported local files before generation submit:

• - Images: jpg/jpeg/png/webp/gif, max 10MB
• Videos: mp4/mov, max 50MB
• Audios: mp3/wav, max 50MB

Upload endpoint used by this skill:

• - Shot scale, angle, and lens feel.
• Camera movement or a clear lock-off choice.
• Lighting direction, material response, and overall mood.
• Subject motion paced to the selected duration.
• One clear visual payoff in the final shot.
• Output framing such as 9:16 vertical when using the default aspect ratio.
• Audio (default-on): Add a labeled Audio: block (ambience, layered SFX, subtle foley—generic, non-copyrighted) even if the user never mentioned sound. JSON generate_audio defaults to true for models that support audio; use false and omit Audio: only when the user explicitly wants silent output.

Dry-run behavior:

• - --dry-run never uploads local files
• output includes uploadPreview to show which local paths would be uploaded

Prompt workflow (mandatory)

Before paid submit, expand brief into production prompt:

1. 1. Decide mode.
2. Map each media to explicit role.
3. Build 2-4 timeline beats by duration.
4. Write one action arc + one final payoff.
5. Add minimal constraints for continuity.

Always show full prompt and all params before submit, then wait for explicit confirmation.

@asset layered referencing

Use explicit role mapping in prompt drafts:

• - Visual anchor: @图片1 / INLINECODE62
• Camera/motion style: INLINECODE63
• Action rhythm: INLINECODE64
• Music/sound bed: INLINECODE65

Good:

• - INLINECODE66

Bad:

• - INLINECODE67

High-value templates

Video extend

• - INLINECODE68
• Set duration to the added segment length.

Video fusion

1. 1. Decide which path fits the request: text, image, multi-image, or first-frame/last-frame.
2. Collect the user's brief, duration, optional aspect_ratio, optional resolution, generate_audio (default true unless the user wants silent), and reference image URLs if the mode uses assets (prefer public https).
3. Expand the prompt with the rules from ## Prompt expansion (mandatory). If the request needs tighter control, read references/seedance-prompt-optimization.md and explicitly decide mode, asset mapping, timeline beats, and negative constraints before writing the final prompt.
4. If you are unsure about current multi-image support or field limits, run node scripts/video_gen.js models --mode multi_image_to_video before a paid request.
5. Show a confirmation table with the full expanded prompt, model, duration, aspect ratio, resolution, audio choice, and any image URLs.
6. After explicit confirmation, run node scripts/video_gen.js wait --json '...'.
7. Return the JSON result. On success, surface the video URLs. On failure, report errorCode and errorMessage and suggest the likely parameter fix.

CLI reference

CODEBLOCK2

Poll timeout classes

• - task_class=short: default 5 minutes (300000ms), intended for text-to-video.
• INLINECODE89: default 20 minutes (1200000ms), intended for image/multi-image/almighty.
• INLINECODE92 (default): infer from effective mode.
• INLINECODE93 remains the highest-priority explicit override.

Compliance notice

• - Do not store WERYAI_API_KEY in repository files.
• Platform compliance for realistic human face references is handled by backend policy; this skill does not implement client-side blocking.

Definition of done

Done when the user receives at least one playable video URL, or a clear failure with errorCode / errorMessage and a concrete next step. The submitted payload must stay within the selected model's supported field set. With default generate_audio: true, the prompt should include Audio: prose unless the user requested silent generation.

Boundaries (out of scope)

• - Do not use local file paths for references unless you have reviewed the assembled scripts/video_gen.js and explicitly consent to local read-and-upload to WeryAI; otherwise prefer public https URLs.
• Do not invent undocumented API fields beyond the JSON surface in this skill.
• Do not assume multi-image or first/last-frame support without checking live metadata when the behavior matters.
• Do not store the secret value of WERYAI_API_KEY inside the repository.
• Do not copy parameter names blindly from another provider without checking the normalized fields in this document.

Model & API constraints (frozen for this skill)

Frozen from the repository's current WeryAI capability snapshots. Re-run node scripts/video_gen.js models after platform upgrades.

Text-to-video (WERYDANCE_2_0)

Image-to-video (WERYDANCE_2_0)

Multi-image and first-frame / last-frame

• - Use the images array for multi-image generation.
• Use either images with ordered URLs, first_frame + last_frame, or image + last_image for start/end-frame control.
• Before a paid submission where multi-image support matters, run node scripts/video_gen.js models --mode multi_image_to_video and confirm support_multiple_images, support_first_last_frame, upload_image_limit, and allowed output fields on the live account.
• If the live registry says the model cannot take multiple images, the runtime falls back to the first image only.

Default parameters

Text brief -> Seedance video

Use this when the user has only an idea and wants Werydance 2.0 to generate the clip from scratch.

Need from the user:

• - Subject or scene
• Motion beat
• Preferred aspect ratio or platform
• Optional duration and resolution

Flow:

1. 1. Expand the brief into a full English prompt.
2. Keep model at WERYDANCE_2_0 unless the user explicitly wants another model.
3. Show a confirmation table:

> 📋 Ready to generate - please confirm
>
> | Field | This run | Notes |
> |-------|----------|-------|
> | model | WERYDANCE_2_0 | Override only if the user explicitly requests another model |
> | aspect_ratio | 9:16 | Must stay inside the Seedance row |
> | duration | 5 | Allowed: 5 / 10 / 15 |
> | resolution | 720p | Allowed: 480p / 720p |
> | generate_audio | true | Default on; Audio: in prompt unless user wants silent |
> | prompt | full expanded prompt | Never show only a summary |

1. 4. After confirmation, run:

CODEBLOCK3

Single reference image -> Seedance motion

Use this when the user already has one reference image and wants subtle or medium motion while preserving the subject.

Need from the user:

• - One reference image URL (prefer public https)
• Desired motion direction
• Optional duration, aspect ratio, and audio

Flow:

1. 1. Expand the prompt around preservation plus motion.
2. Add image to the JSON body.
3. Confirm parameters and URL, then run:

CODEBLOCK4

Multiple reference images -> Seedance storyboard clip

Use this when the user wants several frames turned into one coherent shot or short sequence.

Need from the user:

• - Ordered reference image URLs (prefer public https)
• Desired transition logic
• Optional duration and aspect ratio

Flow:

1. 1. Treat the image order as meaningful story order.
2. If support is uncertain, check models --mode multi_image_to_video first.
3. Confirm the final prompt plus ordered images, then run:

CODEBLOCK5

First frame + last frame -> controlled transition

Use this when the user wants tighter motion control from a known opening frame to a known ending frame.

Need from the user:

• - One reference start-frame URL (prefer public https)
• One reference end-frame URL (prefer public https)
• A prompt that explains the in-between action

Flow:

1. 1. Expand the prompt so it explicitly bridges the first frame to the last frame.
2. Use either first_frame / last_frame, image / last_image, or pass the same two URLs through images in order.
3. Confirm both URLs and the full prompt, then run:

CODEBLOCK6

1. 4. If the live registry rejects multi-image routing, reduce expectations: the runtime will fall back to single-image behavior with the first frame.