Pixverse Pixverse C1 Reference To Video

Pixverse Pixverse C1 Reference To Video

Playground

PixVerse C1 Reference-to-Video generates videos from reference images with subject and background consistency. Use @ref_name in prompts to reference uploaded images. Supports 360p to 1080p resolutions, 1-15 second duration, multiple aspect ratios, and optional audio generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

PixVerse C1 Reference-to-Video

PixVerse C1 Reference-to-Video generates cinematic video guided by reference images. Upload up to 7 reference images as characters, objects, or backgrounds — then describe the scene in your prompt using @ref_name to refer to each reference — and the model produces a cohesive, identity-consistent video that brings your references to life.

• Need to animate a single image? Try PixVerse C1 Image-to-Video
• Need to generate from text only? Try PixVerse C1 Text-to-Video

Why Choose This?

• Multi-reference image support Upload 1 to 7 reference images — characters, objects, or backgrounds — and combine them into a single generated scene.

• Subject and background control Tag each reference as subject (character or object) or background (scene or environment) for more precise compositing.

• @ref_name prompt referencing Reference specific images directly in your prompt using @ref_name for precise control over which element appears where.

• Character-consistent output The model preserves the visual identity of referenced subjects throughout the generated clip.

• Optional native audio generation Enable generate_audio_switch to produce synchronized ambient sound alongside the video.

• Four resolution tiers Generate from 360p up to 1080p to match your quality and delivery requirements.

Parameters

Image Entry Fields

Each image in the images list requires:

How to Use

1. Write your prompt — describe the scene and use @ref_name to reference specific images (e.g. “@hero is running through @city_bg at night.”).
2. Add reference images — provide 1 to 7 images, each with an image_url, type, and ref_name.
3. Select aspect ratio — choose the format that fits your target platform.
4. Select resolution — 360p for fastest/lowest cost, 720p for standard, 1080p for highest quality.
5. Set duration — choose between 1 and 15 seconds.
6. Enable audio (optional) — check generate_audio_switch to generate synchronized native audio.
7. Submit — generate, preview, and download your video.

Pricing

Billing Rules

• Billing is calculated per second of video generated
• Duration range: 1–15 seconds
• Examples: 10s at 720p (no audio) = $0.50 — 10s at 1080p (no audio) = $0.95

Best Use Cases

• Character-driven storytelling — Place consistent characters from reference images into entirely new scenes.
• Brand & product videos — Generate new scenes featuring consistent brand characters or products from reference imagery.
• Social media content — Produce short-form video clips with consistent visual identity from reference photos.
• Creative concepting — Rapidly prototype multi-character or multi-element scenes for pitching and storyboarding.
• Style-consistent series — Maintain a unified visual style across multiple video generations using the same reference set.

Pro Tips

• Assign clear, memorable ref_names (e.g. hero, bg, product) and use them naturally in your prompt.
• Tag environment or scene images as background and characters or objects as subject for the most accurate compositing.
• Use clear, well-lit reference images with distinct subjects for the best identity preservation.
• Use 360p to rapidly test your scene composition before committing to a higher-resolution render.
• Enable audio for scenes with strong ambient environments like outdoor settings, crowds, or action sequences.

Notes

• Both prompt and images are required fields; all other parameters are optional.
• Each image entry must include image_url, type, and ref_name.
• Ensure image URLs are publicly accessible.
• Please follow PixVerse’s content usage policies when crafting prompts.

Related Models

• PixVerse C1 Image-to-Video — Animate a single reference image into a cinematic video clip.
• PixVerse C1 Text-to-Video — Generate video from text prompts without reference images.
• PixVerse C1 Transition — Generate smooth cinematic transitions between two images.

# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/pixverse/pixverse-c1/reference-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "images": [
        {
            "image_url": "",
            "ref_name": "",
            "type": "subject"
        }
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio_switch": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"