Seedance 2.0 Al Video Generator

Generates video via Loova Seedance 2.0 API (Seedance 2.0 video). Requires LOOVA_API_KEY from .env or environment (get API key at loova.ai). Use when the user...

Security Scan

The skill is internally consistent with its stated purpose: it only needs a Loova API key, submits jobs to loova.ai, uploads user-provided files or URLs, and polls for results — there are no unrelated credentials, unusual installs, or hidden endpoints.

Purpose & Capability

Name/description, SKILL.md, README, reference, and the included Python script all align: the code posts to Loova Seedance endpoints and polls for a task result. Required env var LOOVA_API_KEY is appropriate for this API and no unrelated services/binaries are requested.

Instruction Scope

Instructions ask the agent to accept user uploads (or URLs), save local uploads in the workspace (e.g., workspace/assets/) and pass file paths to the script. The script opens and uploads any file paths it is given, and polls once per minute for up to ~3 hours. This behavior is expected for a file-upload video generation skill, but be aware that any local file path passed to the script will be opened and transmitted to the external API — do not pass sensitive local files. Minor documentation inconsistencies: some docs reference GET /api/v1/tasks while others show /v1/tasks (missing /api); these are likely typos but worth verifying against the live API.

Install Mechanism

No install spec; included code uses only Python packages listed in requirements.txt (requests, python-dotenv). No downloads from third-party URLs or archive extraction. This is low-risk and proportionate to the functionality.

Credentials

Declared primary credential is LOOVA_API_KEY which matches the script's Authorization header usage. The script also accepts a fallback env var LOOAI_API_KEY (not declared in metadata), a minor discrepancy. The skill does not request additional secrets or system config paths.

Persistence & Privilege

always is false and the skill is user-invocable; it does not request persistent or elevated platform privileges or alter other skills. It will only act when invoked and does not install background services.

Assessment

This skill appears to do what it says: it needs your LOOVA_API_KEY and will send prompts, URLs, and any local files you provide to api.loova.ai to generate videos (generation can take hours and the script polls once per minute). Before installing: (1) Only provide an API key you trust Loova with and check your account permissions/rate limits; (2) avoid passing paths to sensitive local files — the script will open and upload any file paths you provide; (3) verify which exact task-status endpoint the live API expects (docs include a small /api vs /v1 mismatch); (4) note the script also checks an undocumented LOOAI_API_KEY env var as a fallback — if you rely on strict env control, be aware of this alternate name. If those points are acceptable, the skill is coherent with its stated purpose.

Seedance 2.0 Video Generator

Create AI videos from text or images using the latest multi-modal reference system with the Loova Seedance 2.0 API (Seedance 2.0 Video). Submit a job, poll for completion, and get the video result. Generation may take up to 3 hours; poll once per minute and return to the user immediately when status becomes succeeded or failed (or any terminal error state). Stop polling immediately on failure/error and return the error details to the user.

Capabilities

1. Image to Video – Turn images into videos using the Loova Seedance 2.0 Video API, powered by Seedance 2.0 or Seedance 2.0 Fast.
2. Text to Video – Convert text into videos with the Loova Seedance 2.0 Video API, powered by Seedance 2.0 or Seedance 2.0 Fast.
3. Multi-Modal Reference System – Supports multiple input types, including text, images, videos, and audio. These inputs can be used as references for different parts of your video.
4. Configurable Settings – Customize duration (4–15 seconds), aspect ratio, and function mode (first frame, last frame, or omni reference).
5. Attachment-friendly workflow

• When users provide media via URL, pass it directly using --image-urls, --video-urls, or --audio-urls (no download required).
• When users upload files in chat (images, videos, or audio), save them locally in the OpenClaw workspace (e.g., workspace/assets/) and pass the file paths via --files.
• If both URLs and local files are provided for the same media type, URLs take precedence (local files of the same type will be ignored).

Quick Start

# Generate video from prompt only
python scripts/run_seedance.py --prompt "Camera slowly pushes in, person smiles"

# With local file(s) (sent as FormData File uploads)
python scripts/run_seedance.py --prompt "Person turns head" --files "photo.jpg" --duration 8

# Fast model, custom ratio
python scripts/run_seedance.py --prompt "A cat in the sun" --model seedance_2_0_fast --ratio "16:9"

Setup

Required API Key

Obtain your API key from your account after logging in at https://loova.ai/. Do not hardcode the key; use environment variables or .env.

Add to your environment or .env file in the project root:

# Required for Loova API
LOOVA_API_KEY=your_api_key_here

Create .env from the example:

cp .env.example .env
# Edit .env and set LOOVA_API_KEY

The script loads variables from .env automatically (via python-dotenv). You can also export LOOVA_API_KEY in your shell.

Install Dependencies

pip install -r requirements.txt

Dependencies: requests, python-dotenv. No FFmpeg or other system binaries required.

Usage Examples

1. Text to Video (prompt only)

python scripts/run_seedance.py --prompt "A futuristic city at night with flying cars" --duration 5

2. Image to Video (with reference image URL)

python scripts/run_seedance.py --prompt "Person slowly smiles" --image-urls "https://your-cdn.com/portrait.jpg" --duration 8

3. Multiple Reference Images

python scripts/run_seedance.py --prompt "Smooth transition between scenes" --image-urls "https://example.com/a.jpg,https://example.com/b.jpg" --function-mode first_last_frames

4. Fast Model, Custom Aspect Ratio

python scripts/run_seedance.py --prompt "Ocean waves" --model seedance_2_0_fast --ratio "9:16" --duration 6

Scripts Reference

Script	Description
scripts/run_seedance.py	Submit Seedance 2.0 video task and poll until done; prints result JSON (includes video URL on success)

Arguments: --prompt (required), --model, --duration, --ratio, --function-mode, --files (comma-separated local paths; sent as multipart File uploads). URL inputs: --image-urls, --video-urls, --audio-urls (comma-separated). When no files are uploaded, the request uses Content-Type: application/json; when uploading files it uses multipart/form-data. Note: for multipart uploads, let the HTTP client set Content-Type with boundary automatically; do not set Content-Type manually.

API Flow

1. Submit – POST https://api.loova.ai/api/v1/video/seedance-2 with Authorization: Bearer <API_KEY>; response contains task_id.
2. Poll – GET https://api.loova.ai/api/v1/tasks?task_id=<task_id> once per minute until status is succeeded or failed.
3. Result – Response includes the video result (e.g. URL). Script prints full JSON.

Parameters Summary

Parameter	Required	Default	Description
model	Yes	seedance_2_0	seedance_2_0 or seedance_2_0_fast
prompt	Yes	—	Prompt; supports @ reference syntax
functionMode	No	—	first_last_frames or omni_reference
(multipart) files	No	—	Optional File parts (images/video/audio); sent as multipart/form-data
image_urls	No	—	Optional image URL list (pass via --image-urls)
video_urls	No	—	Optional video URL list (pass via --video-urls)
audio_urls	No	—	Optional audio URL list (pass via --audio-urls)
ratio	No	16:9	Aspect ratio
duration	No	5	Duration in seconds (4–15)

For full API details, see reference.md. For a short setup guide, see QUICK_START.md.