pixverse/c1-r2v

c1-r2v
Docs
Schema

[Core Function] PixVerse c1 reference-to-video (fusion) generates a video from a prompt while preserving subjects from 1-7 reference images; each reference can be tagged as subject/background and named for @-reference in the prompt. [Strengths] Precise multi-subject composition and identity preservation. [Best For] Putting specific characters/objects into a new scene, multi-character interactions. [Limitations] Do NOT use this for single-image animation (use Image-to-Video), two-frame transitions (use First-Last-Frame), or text-only generation (use Text-to-Video). It requires 1-7 reference images and a required aspect_ratio, and supports up to 1080p and a maximum of 15s. [Routing] Use when the user provides one or more reference images to be fused into the video, especially when distinguishing subject vs background or naming references for the prompt. The v6 and c1 reference-to-video variants accept identical parameters; choose the version the user requests.

$0.0690~$0.2760/sec
image-to-video

Input

Text prompt; may reference named images via @ref_name (e.g. "@hero in @forest").
Video aspect ratio (required).
aspect_ratio
Video duration in seconds (required).
Output resolution (required).
quality
Reference images (1-7) fused into the generated video. Each item is an object: a publicly accessible image URL, plus optional role (type: subject/background) and a name (ref_name) you can reference in the prompt via @ref_name for precise multi-subject control.
Item 1
ref_name

Optional name (<=30 chars) for this reference. Reference it in the prompt via @ref_name for precise multi-subject composition, e.g. prompt "@hero runs through @forest".

type
type

Role of this reference image: subject (main character/object) or background (scene). Optional.

url*
Hint: Drag and drop files, paste from clipboard (Ctrl/Cmd+V), or provide a URL.

Reference image URL (publicly accessible; png/jpeg/jpg/webp).

Whether to generate audio.
Random seed (omit for random).

Result

No results yet

Run the model to preview the output here.

Next:

README

Parameters

Name Description Type Required Enums
prompt Text prompt; may reference named images via @ref_name (e.g. “@hero in @forest”). string Yes -
aspect_ratio Video aspect ratio (required). string Yes 16:9, 9:16, 1:1, 3:4, 4:3, 2:3, 3:2, 21:9
duration Video duration in seconds (required). integer Yes -
quality Output resolution (required). string Yes 360p, 540p, 720p, 1080p
reference_images Reference images (1-7) fused into the generated video. Each item is an object: a publicly accessible image URL, plus optional role (type: subject/background) and a name (ref_name) you can reference in the prompt via @ref_name for precise multi-subject control. object[] Yes -
generate_audio_switch Whether to generate audio. boolean No true, false
seed Random seed (omit for random). integer No -

Pricing

Unit: $/sec

Dimension Pricing
quality: 360p / generate_audio_switch: true 0.0920
quality: 540p / generate_audio_switch: true 0.1150
quality: 720p / generate_audio_switch: true 0.1495
quality: 1080p / generate_audio_switch: true 0.2760
quality: 360p / generate_audio_switch: false 0.0690
quality: 540p / generate_audio_switch: false 0.0920
quality: 720p / generate_audio_switch: false 0.1150
quality: 1080p / generate_audio_switch: false 0.2185
  • pixverse/c1-t2v: [Core Function] PixVerse c1 T2V generates a video purely from a text prompt, with no input image. [Strengths] Strong prompt adherence and smooth motion; optional audio. [Best For] Turning an idea or script into video, concept visualization, story beats, social clips from text. [Limitations] Do NOT use this when the user provides a starting image, two frames, or reference images; route to Image-to-Video, First-Last-Frame, or Reference-to-Video instead. c1 does not support multi-clip. [Routing] Use for text-only generation. The c1 variant takes the same inputs as v6 except it does not support multi-clip generation; choose c1-t2v when the user requests the c1 model and multi-clip is not needed.
  • pixverse/c1-fl2v: [Core Function] PixVerse c1 first-last-frame generates a video that transitions from a start frame to an end frame, guided by a prompt. [Strengths] Controlled start/end composition with smooth interpolation. [Best For] Morphs, scene transitions, before/after motion. [Limitations] Do NOT use this if you only have a single image (use Image-to-Video) or lack an end frame; it requires exactly two images (a first and a last frame) and supports up to 1080p and a maximum of 15s. [Routing] Use when the user provides a start image AND an end image. For one image use Image-to-Video. The v6 and c1 first-last-frame variants accept identical parameters; choose the version the user requests.
  • pixverse/c1-i2v: [Core Function] PixVerse c1 I2V animates a single starting image into a video guided by a text prompt. [Strengths] Smooth, prompt-guided motion from one frame; optional audio. [Best For] Bringing a photo/illustration to life, product showcases, quick cinematic motion from a still. [Limitations] Do NOT use this for two-frame transitions (use First-Last-Frame), multi-subject fusion (use Reference-to-Video), or text-only generation (use Text-to-Video). It requires exactly one starting image, does not support multi-clip, and supports up to 1080p and a maximum of 15s. [Routing] Use when the user provides one starting image. The c1 variant matches v6 inputs but does not support multi-clip generation; choose c1-i2v when the user requests the c1 model and multi-clip is not needed.

More in this series