SCAIL-2 Character Animation API

SCAIL-2 — End-to-End Character Animation

SCAIL-2 generates character animation from a single reference image and a driving video. Upload a character image, provide a driving video, choose a generation mode, and create an animated or replacement-style video result.

SCAIL-2 supports two modes:

Animation Mode — animate the reference character using the driving video's motion.
Replacement Mode — replace the driving video's subject with the reference character while preserving the original scene.

Key Features

Image-to-video character animation Animate a reference character image using motion from an input driving video.
Subject replacement Swap the subject in the driving video with the reference character while preserving the original scene structure.
Two generation modes Use animate for motion-driven character animation or replace for subject replacement.
Long-video support Supports input video duration up to 120 seconds for billing calculation.
Audio passthrough The driving video's audio track is preserved in the output.

Parameters

Parameter	Required	Description
image	Yes	Reference character image. JPG or PNG is recommended; avoid WEBP.
video	Yes	Driving video that provides the motion.
prompt	No	Optional positive prompt describing the desired output. Default: empty string.
mode	No	Generation mode: `animate` or `replace`. Default: `animate`.
resolution	No	Output resolution tier: `480p` or `720p`. Default: `480p`.
seed	No	Random seed. Use `-1` for a random seed. Default: `-1`.

How to Use

Upload image — Provide a clear reference image of the character. JPG or PNG is recommended.
Upload video — Provide the driving video that contains the motion.
Add prompt (optional) — Describe the desired output, such as style, character details, or scene quality.
Choose mode — Select animate to animate the reference character, or replace to swap the video subject with the reference character.
Select resolution — Choose 480p for the default output or 720p for higher resolution.
Generate — Create the final video result.

Pricing

Resolution	Price per 5 s	Price per second	Max billed duration
480p	$0.20	$0.04 / s	120 s
720p	$0.40	$0.08 / s	120 s

Billing Rules

Minimum charge: 5 seconds. Any video shorter than 5 seconds is billed as 5 seconds.
Maximum billed duration: 120 seconds.
720p costs 2x the 480p price.
Billing is based on the input video duration after applying the 5-second minimum and 120-second maximum cap.

Best Use Cases

Character animation — Animate a reference character using motion from a driving video.
Dance and gesture transfer — Transfer body movement, gestures, and performance motion to a reference character.
Subject replacement — Replace the main subject in a video with a reference character.
Avatar content creation — Generate character videos for social media, entertainment, and creative projects.
Video variation — Recreate the same motion with different character references.

Pro Tips

Use a clear reference image with the character visible.
JPG or PNG is recommended; avoid WEBP.
Use a driving video with a clearly visible main subject.
Keep the reference image's camera angle close to the driving video's framing when possible.
Use animate when you want to drive the reference character with the video motion.
Use replace when you want to swap the video subject with the reference character.
Use 480p for testing and 720p for higher-resolution output.
Add a prompt when you want more control over the style or visual details.

Notes

image and video are required fields.
prompt, mode, resolution, and seed are optional.
Default mode is animate.
Default resolution is 480p.
Default seed is -1, which uses a random seed.
Minimum billing duration is 5 seconds.
Maximum billed duration is 120 seconds.
Ensure uploaded image and video URLs are publicly accessible.

Scail 2 API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/scail-2 with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Scail 2 below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/scail-2" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg",
    "video": "https://example.com/your-input.mp4",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "mode": "animate",
    "resolution": "480p",
    "seed": -1
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey, {
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

try {
  const result = await client.run("wavespeed-ai/scail-2", {
        "image": "https://example.com/your-input.jpg",
        "video": "https://example.com/your-input.mp4",
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "mode": "animate",
        "resolution": "480p",
        "seed": -1
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(
    api_key=os.environ["WAVESPEED_API_KEY"],
    max_connection_retries=5,
    retry_interval=1.0,
)

try:
    output = client.run(
        "wavespeed-ai/scail-2",
        {
    "image": "https://example.com/your-input.jpg",
    "video": "https://example.com/your-input.mp4",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "mode": "animate",
    "resolution": "480p",
    "seed": -1
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Scail 2 API — Frequently asked questions

What is the Scail 2 API?

Scail 2 is a WaveSpeedAI model for pose / motion driven video, exposed as a REST API on WaveSpeedAI. SCAIL-2 is a fast AI character animation and subject replacement model that preserves identity and motion from a single reference image and a driving video. It supports both Animation mode and Replacement mode at 480p or 720p. Ready-to-use REST inference API for character animation, motion transfer, subject replacement, social media clips, creative video editing, and professional image-to-video workflows with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Scail 2 API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/scail-2.

How much does Scail 2 cost per run?

Scail 2 starts at $0.20 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Scail 2 accept?

Key inputs: `prompt`, `image`, `video`, `resolution`, `seed`, `mode`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/scail-2.

How do I get started with the Scail 2 API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Scail 2 outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

サンプルすべて表示

関連モデル

README