SkyReels V4 Reference to Video API

Skywork AI SkyReels V4 Reference-to-Video

Skywork AI SkyReels V4 Reference-to-Video generates videos from reference images, with optional reference video guidance for stronger motion and scene control. It supports standard and fast modes, multiple resolutions, optional sound effects, and prompt-driven generation for character consistency, product motion, scene transfer, and other reference-based video workflows.

Why Choose This?

Reference-guided video generation Use up to 3 reference images to guide identity, appearance, style, or scene elements.
Optional reference video support Add up to 1 reference video when you want stronger motion or temporal guidance.
Two generation modes Choose std for higher-quality output or fast for quicker, lower-cost generation.
Multiple resolutions Supports 480p, 720p, and 1080p to balance quality and budget.
Flexible aspect ratios Choose 16:9, 9:16, or 1:1 depending on your target platform.
Production-ready workflow Suitable for character-driven video, product clips, stylized motion design, and reference-based storytelling.

Parameters

Parameter	Required	Description
prompt	Yes	The prompt describing the generated video. Reference tags are added automatically when missing.
images	No	Reference image URLs. Upload up to `3` images.
ref_videos	No	Optional reference video URL. Upload at most `1` video.
aspect_ratio	No	Aspect ratio of the generated video. Supported values: `16:9`, `9:16`, `1:1`. Default: `16:9`.
duration	No	Duration of the generated video in seconds. Range: `3–15`. Default: `5`.
resolution	No	Output video resolution. Supported values: `480p`, `720p`, `1080p`. Default: `1080p`.
sound	No	Whether to generate sound effects with the video. Default: `false`.
mode	No	Quality/performance mode. Supported values: `std`, `fast`. Default: `std`. `fast` mode currently requires `sound=false`.

How to Use

Write your prompt — describe the motion, scene, camera movement, and visual direction you want.
Add reference images (optional) — upload up to 3 images to guide identity, look, or scene consistency.
Add a reference video (optional) — upload 1 video if you want stronger motion or temporal guidance.
Choose aspect ratio — select 16:9, 9:16, or 1:1.
Set duration — choose a clip length between 3 and 15 seconds.
Choose resolution — use 480p, 720p, or 1080p depending on quality and cost needs.
Choose mode — use std for higher quality or fast for quicker generation.
Enable sound (optional) — turn this on if you want generated sound effects. If using fast, keep sound=false.
Submit — run the model and download the generated video.

Example Prompt

A cinematic fashion shot with smooth camera movement, elegant character motion, soft studio lighting, premium commercial pacing, and stable identity across the sequence.

Pricing

Pricing depends on duration, resolution, mode, and whether you use a reference video.

Without Reference Video

Standard Mode

Resolution	Per Second	5s Cost
480p	$0.11	$0.55
720p	$0.14	$0.70
1080p	$0.35	$1.75

Fast Mode

Resolution	Per Second	5s Cost
480p	$0.08	$0.40
720p	$0.11	$0.55
1080p	$0.275	$1.375

With Reference Video

Standard Mode

Resolution	Per Second	5s Cost
480p	$0.18	$0.90
720p	$0.25	$1.25
1080p	$0.625	$3.125

Fast Mode

Resolution	Per Second	5s Cost
480p	$0.15	$0.75
720p	$0.20	$1.00
1080p	$0.50	$2.50

Example Costs

Without Reference Video · Standard Mode

Resolution	3s	5s	10s	15s
480p	$0.33	$0.55	$1.10	$1.65
720p	$0.42	$0.70	$1.40	$2.10
1080p	$1.05	$1.75	$3.50	$5.25

Without Reference Video · Fast Mode

Resolution	3s	5s	10s	15s
480p	$0.24	$0.40	$0.80	$1.20
720p	$0.33	$0.55	$1.10	$1.65
1080p	$0.825	$1.375	$2.75	$4.125

With Reference Video · Standard Mode

Resolution	3s	5s	10s	15s
480p	$0.54	$0.90	$1.80	$2.70
720p	$0.75	$1.25	$2.50	$3.75
1080p	$1.875	$3.125	$6.25	$9.375

With Reference Video · Fast Mode

Resolution	3s	5s	10s	15s
480p	$0.45	$0.75	$1.50	$2.25
720p	$0.60	$1.00	$2.00	$3.00
1080p	$1.50	$2.50	$5.00	$7.50

Billing Rules

Base multiplier starts from $0.10 per second
Pricing scales linearly with duration
Prices differ between std and fast
Adding a ref_videos input increases the rate
sound does not affect pricing directly
fast mode currently requires sound=false

Best Use Cases

Character consistency — Use reference images to keep the same person or style across a clip.
Motion-guided generation — Add a reference video when movement or pacing matters.
Product and fashion videos — Build polished, controlled motion clips from still references.
Creative prototyping — Use fast mode for quick iteration before moving to std.
Reference-based storytelling — Combine image identity guidance with optional motion guidance.

Pro Tips

Use reference images when identity, styling, or appearance matters most.
Add a reference video only when you need stronger motion or temporal guidance.
Keep prompts focused on motion, camera behavior, and scene progression.
Use fast mode for rough iteration, then switch to std for final-quality output.
Keep sound=false in fast mode.
Start with shorter durations to validate the concept before generating longer clips.

Notes

prompt is required.
images supports up to 3 reference images.
ref_videos supports up to 1 reference video.
duration supports 3–15 seconds.
resolution defaults to 1080p.
mode defaults to std.
fast mode currently requires sound=false.
Pricing depends on duration, resolution, mode, and whether a reference video is included.

Related Models

Skywork AI SkyReels V4 Text-to-Video — Generate videos directly from text prompts.
Skywork AI SkyReels V4 Image-to-Video — Generate videos from a first-frame image with optional middle and end frame guidance.
Skywork AI SkyReels V3 Reference-to-Video — Earlier reference-based video workflow in the SkyReels lineup.
Skywork AI SkyReels V3 Extend Video — Continue an existing video clip with newly generated footage.

Skyreels v4 Reference To Video API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/skywork-ai/skyreels-v4/reference-to-video with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Skyreels v4 Reference To Video below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/skywork-ai/skyreels-v4/reference-to-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "sound": false,
    "mode": "std"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("skywork-ai/skyreels-v4/reference-to-video", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "16:9",
        "duration": 5,
        "resolution": "1080p",
        "sound": false,
        "mode": "std"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "skywork-ai/skyreels-v4/reference-to-video",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "sound": false,
    "mode": "std"
}
)

print(output["outputs"][0])  # → URL of the generated output

Skyreels v4 Reference To Video API — Frequently asked questions

What is the Skyreels v4 Reference To Video API?

Skyreels v4 Reference To Video is a Skywork Ai model for video generation from images, exposed as a REST API on WaveSpeedAI. SkyReels V4 Reference to Video is a fast AI reference-to-video generation model that creates high-quality videos from reference images or a reference video and a text prompt using the SkyReels V4 omni-video workflow. Ready-to-use REST inference API for character-consistent videos, product visuals, branded storytelling, social media clips, advertising creatives, concept videos, and professional reference-based video generation 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 Skyreels v4 Reference To Video 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 prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/skywork-ai/skywork-ai-skyreels-v4-reference-to-video.

How much does Skyreels v4 Reference To Video cost per run?

Skyreels v4 Reference To Video starts at $0.10 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 Skyreels v4 Reference To Video accept?

Key inputs: `prompt`, `images`, `aspect_ratio`, `resolution`, `duration`, `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/skywork-ai/skywork-ai-skyreels-v4-reference-to-video.

How do I get started with the Skyreels v4 Reference To Video 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 Skyreels v4 Reference To Video outputs commercially?

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

EsempiVedi tutto

Modelli correlati

README

Skywork AI SkyReels V4 Reference-to-Video

Why Choose This?

Parameters

How to Use

Example Prompt

Pricing

Without Reference Video

Standard Mode

Fast Mode

With Reference Video

Standard Mode

Fast Mode

Example Costs

Without Reference Video · Standard Mode

Without Reference Video · Fast Mode

With Reference Video · Standard Mode

With Reference Video · Fast Mode

Billing Rules

Best Use Cases

Pro Tips

Notes

Related Models

Skyreels v4 Reference To Video API — Quick start

Skyreels v4 Reference To Video API — Frequently asked questions