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
| Parameter | Required | Description |
|---|
| prompt | Yes | Text description of the scene. Use @ref_name to reference specific images. |
| images | Yes | List of 1–7 reference images. Each entry requires image_url, type, and ref_name. |
| aspect_ratio | No | Output aspect ratio. Options: 16:9 (default), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9. |
| resolution | No | Output resolution: 360p, 540p, 720p (default), or 1080p. |
| duration | No | Clip length in seconds. Range: 1–15. Default: 5. |
| generate_audio_switch | No | Whether to generate native audio for the video. Default: off. |
Image Entry Fields
Each image in the images list requires:
| Field | Description |
|---|
| image_url | URL of the reference image. |
| type | Reference type: subject (character or object) or background (scene or environment). |
| ref_name | A short name for this reference. Use @ref_name in your prompt to refer to this image. |
How to Use
- Write your prompt — describe the scene and use @ref_name to reference specific images (e.g. "@hero is running through @city_bg at night.").
- Add reference images — provide 1 to 7 images, each with an image_url, type, and ref_name.
- Select aspect ratio — choose the format that fits your target platform.
- Select resolution — 360p for fastest/lowest cost, 720p for standard, 1080p for highest quality.
- Set duration — choose between 1 and 15 seconds.
- Enable audio (optional) — check generate_audio_switch to generate synchronized native audio.
- Submit — generate, preview, and download your video.
Pricing
| Resolution | Without Audio | With Audio |
|---|
| 360p | $0.030/s | $0.040/s |
| 540p | $0.040/s | $0.050/s |
| 720p | $0.050/s | $0.065/s |
| 1080p | $0.095/s | $0.120/s |
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.