1. Guides
PixVerse Platform Docs
  • Overview
    • Introduction to PixVerse API Platform
    • Quick Start
    • How does the API work?
    • How to get API key?
    • PixVerse-api-llm.txt
  • Models
    • Model Overview
    • Capability matrix
    • C1
    • V6
    • Pricing
  • Guides
    • Get video generation status
    • Check account balance
    • Subscribe API plans
    • Text-to-video
    • Image-to-video
    • Video Effects
    • Image template
    • Transition(First-last frame Feature)
    • Extend
    • Modify
    • Sound effects
    • Speech(Lip sync)
    • Lip sync TTS speaker list
    • Fusion(Reference to video)
    • Fusion (Reference-to-Video) — V6 Video Reference Integration Guide
    • Restyle
    • Multi-transition
    • Swap
    • Motion Control(Mimic)
    • Webhook integration
    • Get template list
    • Avatar
  • API Reference
    • Rate limit
    • Video Generation
      • Text-to-Video generation
      • Image-to-Video generation
      • Template video generation
      • Transition(First-last frame) generation
      • Speech(Lipsync) generation
      • Get Speech(Lipsync) tts list
      • Fusion(reference to video) generation
      • Multi-transition video generation
      • Restyle video generation
      • Restyle effect list
      • Swap mask generation
      • Swap video generation
      • Sound effect generation
      • Extend generation
      • Get Video Generation Status
      • Motion Control (Mimic) generation
      • Modify generation
      • Upscale Video
      • Avatar generation
    • Image generation
      • Image template generation
      • Get Image generation
    • Upload Image
    • Get user credit balance
    • Upload Video&audio
    • Get template list
    • Create Custom Voice
    • Delete Custom Voice
  • Troubleshooting
    • FAQ
    • Common errors and Solutions
    • Error codes
  • Resources
    • Support
    • Changelogs
    • PixVerse MCP
    • Terms of Service
    • Privacy policy
  1. Guides

Fusion (Reference-to-Video) — V6 Video Reference Integration Guide

Overview#

V6 supports video references. The model can understand and reference subjects, actions, scenes, camera movements, and visual styles from input videos. It can also modify video content based on prompts to achieve effects such as subject replacement, video recreation, and motion imitation.

How to Use Video References#

Step 1: Upload the Reference Video#

After the video is uploaded successfully, save the returned media_id:
{
  "ErrCode": 0,
  "ErrMsg": "success",
  "Resp": {
    "media_id": 123456789,
    "media_type": "video",
    "url": "https://media.pixverseai.cn/example.mp4"
  }
}

Step 2: Generate a Video Using the Reference Video#

A successful request returns a video_id. Use this ID to poll the video status endpoint until status changes from 5 to 1. You can then retrieve the generated video from the returned url.

Notes#

1.
video_references is supported only by the V6 model, and reference_mode must be set to omni.
2.
A maximum of two reference videos can be included in each request.
3.
The total duration of all reference videos must not exceed 15 seconds.
4.
When using video references, duration must be set to 0. The output duration will automatically match the longest reference video.
5.
V6 Omni mode supports up to 10 reference images and two reference videos.
6.
V6 Omni mode supports setting aspect_ratio to "auto".
without video_references
QualityBilling standardswith no audiowith audio
360p1s57
540p1s79
720p1s912
1080p1s1823
with video_references
QualityBilling standardswith no audiowith audio
360p1s1014
540p1s1418
720p1s1824
1080p1s3646
Previous
Fusion(Reference to video)
Next
Restyle