PixVerse v6 Reference to Video
Drive PixVerse v6 with up to 7 reference images and bind them directly in your prompt as @image1, @image2. Keep characters, objects and scenes consistent across 1-15 second videos at 360p to 1080p, with eight aspect ratios and optional synchronized audio.
10% less than the priciest provider (2 compared). Same model, same output.
1-7 reference images for characters, objects or scenes. Bind them in the prompt as @image1, @image2 in upload order.
Duration
Duration of the generated video in seconds (1-15). On Extend this is the length of the new extension. Billed per second.
Resolution
Output resolution. 720p is the model's default.
Aspect Ratio
Aspect ratio of the generated video.
Audio
Generate synchronized audio (music, sound effects, dialogue). Adds a per-second surcharge.
10% less than the priciest provider (2 compared). Same model, same output.
Your result renders here.
Use PixVerse v6 Reference to Video via the API
Generate with PixVerse v6 Reference to Video from your own code. Async by design: submit a generation, get a run id back instantly, poll until it completes. Billed in credits at the best available provider price — from $0.02 per second.
1 — Start a generation
curl -X POST https://app.scenetra.com/api/v1/generate/pixverse-v6-ref2v \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"@image1 walks through @image2 at golden hour, handheld follow shot","images":["https://example.com/person.jpg","https://example.com/street.jpg"],"duration":"5"}'Response (202)
{
"runId": "run_abc123",
"status": "PENDING",
"model": "pixverse-v6-ref2v",
"estimatedCredits": 203,
"statusUrl": "/api/v1/runs/run_abc123"
}2 — Poll until COMPLETED (every 2-5 seconds)
curl https://app.scenetra.com/api/v1/runs/run_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"runId": "run_abc123",
"status": "COMPLETED",
"progress": { "completed": 1, "total": 1 },
"outputs": [
{ "type": "video", "url": "https://images.scenetra.com/..." }
],
"error": null,
"estimatedCredits": 203
}Request fields
| Field | Type | Description | Default |
|---|---|---|---|
| prompt* | string | Describe the video and bind your references by upload order: '@image1 walks through @image2'. | — |
| images | string[] (https URLs) | 1-7 reference images for characters, objects or scenes. Bind them in the prompt as @image1, @image2 in upload order. | — |
| duration | string | Duration of the generated video in seconds (1-15). On Extend this is the length of the new extension. Billed per second.1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 | 5 |
| resolution | string | Output resolution. 720p is the model's default.360p · 540p · 720p · 1080p | 720p |
| aspect_ratio | string | Aspect ratio of the generated video.16:9 · 4:3 · 1:1 · 3:4 · 9:16 · 2:3 · 3:2 · 21:9 | 16:9 |
| generate_audio_switch | string | Generate synchronized audio (music, sound effects, dialogue). Adds a per-second surcharge.false · true | false |
| callbackUrl | string (https URL) | Optional. When the run finishes (completed or failed), we POST the final run status to this URL — same shape as the poll response, plus model, params, and chargedCredits. Best-effort; polling remains the source of truth. | |
Unknown fields are rejected with a helpful 400. Media fields take https URLs. There is no provider parameter — every run is routed to the cheapest capable provider automatically.
Good to know
Billing
Runs bill your account credits at provider cost with 0% markup. The submit response includes the credit estimate; failed generations are refunded automatically. Add ?dryRun=1 to get the estimate without running anything.
Errors
Errors are always { "error": { "code", "message" } } with stable codes: unauthorized, model_not_available, invalid_parameter, insufficient_credits, rate_limited. A failed run is not an HTTP error — poll responses report status: "FAILED" with the reason.
What makes PixVerse v6 Reference to Video different
Any length from 1 to 15 seconds
PixVerse v6 generates whole-second durations from 1 to 15 seconds in a single pass. One-second clips are perfect for cheap prompt testing — a 360p test costs about two cents per second — and 15 seconds is enough for a complete scene. There are no fixed 5s/10s presets to work around.
Synchronized audio as an opt-in add-on
Flip the Generate Audio toggle and v6 produces background music, sound effects and dialogue that match your prompt. Audio is priced as a per-second surcharge — from $0.008/s at 360p and 540p up to $0.02/s at 1080p — so silent drafts stay cheap and you only pay for sound on the clips that need it.
Multi-shot sequences in one generation
The Multi-Shot toggle turns a single prompt into a sequence with scene transitions and dynamic camera changes — cuts, angle switches and camera moves generated in one pass instead of stitching separate clips. Describe the beats in your prompt and let the model handle the editing.
Eight aspect ratios, four resolutions
Output at 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 or cinematic 21:9, at 360p, 540p, 720p or 1080p. A practical workflow on a Scenetra board: iterate at 360p ($0.02/s), then switch the resolution select to 1080p ($0.072/s) for the final render — same node, same wiring, and every generation is billed at provider cost with 0% markup.
Parameters
| Parameter | Type | Description | Default |
|---|---|---|---|
| Prompt* | text | Describe the scene, action, camera and style. With audio enabled, BGM, SFX and dialogue are generated to match. | — |
| Duration | select | Duration of the generated video in seconds (1-15).1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 | 5 |
| Resolution | select | Output resolution. 720p is the model's default.360p · 540p · 720p · 1080p | 720p |
| Aspect Ratio | select | Aspect ratio of the generated video.16:9 · 4:3 · 1:1 · 3:4 · 9:16 · 2:3 · 3:2 · 21:9 | 16:9 |
| Generate Audio | boolean | Generate synchronized audio (BGM, SFX, dialogue). Adds a per-second surcharge. | false |
| Multi-Shot | boolean | Generate a multi-shot sequence with scene transitions and dynamic camera changes in one pass. | false |
Pricing
From $0.02 per second
Pay per generation — only pay for what you use.
360p
$0.02/s
per second
540p
$0.028/s
per second
720p
$0.036/s
per second
1080p
$0.072/s
per second
Synchronized audio
+$0.008-$0.02/s
per second
What a video costs
| Duration | 360p | 540p | 720p | 1080p |
|---|---|---|---|---|
| 5 seconds | $0.10 | $0.14 | $0.18 | $0.36 |
| 10 seconds | $0.20 | $0.28 | $0.36 | $0.72 |
Use cases
Social content
- Vertical 9:16 shorts with sound
- Multi-shot story sequences
- Sound-on hooks and intros
- Cheap 360p concept tests
Marketing & ads
- Product teaser clips
- Campaign variants in every ratio
- Cinematic 21:9 brand spots
- A/B test drafts at $0.02/s
Film & previz
- Multi-shot scene previz
- Establishing shots from prompts
- Mood pieces with generated BGM
- Camera-move exploration
Education & explainers
- Illustrated concept clips
- Narrated scenes with dialogue
- Square 1:1 course assets
- Quick visual metaphors
Frequently asked questions
What is PixVerse v6 Reference-to-Video?+
A v6 mode that generates video from up to 7 reference images. You upload references for characters, objects or scenes and bind them in the prompt by upload order — "@image1 rides @image2 through @image3" — and the model keeps those subjects consistent in the output. Videos run 1-15 seconds at 360p to 1080p in eight aspect ratios.
How do I reference images in the prompt?+
By upload order: the first image you add is @image1, the second is @image2, and so on up to @image7. Write the prompt as if the tags were the subjects — "@image1 walks through @image2" — so each reference gets an explicit role instead of being blended in loosely.
How is this different from image-to-video?+
Image-to-video uses one image as the literal first frame and animates from it. Reference-to-video uses your images as identity references — they define what characters, objects and scenes look like, while the prompt freely composes a new shot around them in any of the eight aspect ratios. Use i2v to animate a finished frame; use references to keep subjects consistent across many different shots.
Can I keep the same character across multiple videos?+
Yes — that's the core use case. Reuse the same reference image (or set of images) across generations and the character stays consistent scene after scene. On a Scenetra board you can fan one reference image out to many Reference to Video nodes and batch a whole series.
Does reference-to-video support audio?+
Yes. Enable the Generate Audio toggle and v6 generates BGM, sound effects and dialogue synchronized to the video, billed as a per-second surcharge on top of the base rate.
One-click tools built on PixVerse v6 Reference to Video
Ready-made workflows — fill in a form, no node editor needed.
Related models
Seedance 2.5
ByteDance's Seedance 2.5 generates cinematic videos up to 30 seconds from text prompts with synchronized audio — voice, sound effects, and background music — built in by default. The newest Seedance generation, with mp4 or high-fidelity mov output for multi-round editing pipelines.
View model →Kling 3.0 Pro
Kuaishou's flagship video generation model delivering stunning visual fidelity. Kling 3.0 Pro supports text-to-video, image-to-video with start/end frames, element references for character consistency, and native audio generation.
View model →MiniMax H3
MiniMax H3 is the newest generation of the Hailuo video lineage: 5-15 second clips with native stereo audio — dialogue, music, and sound effects rendered in the same pass as the picture. Generate at 480P or 768P natively, or step up to 2K and 4K upscaled output, in six aspect ratios from cinematic 21:9 to vertical 9:16.
View model →Wan 3.0
Alibaba's Wan 3.0 generates up to 30 seconds of video in a single take, with native synchronized audio — dialogue, sound effects, and music — produced in the same pass as the picture. Pick any duration from 2 to 30 seconds, output at 480p, 720p, or 1080p, and choose from five aspect ratios or let the model frame the shot automatically.
View model →Start creating with PixVerse v6 Reference to Video
Use PixVerse v6 Reference to Video alongside 50+ other AI models in Scenetra's visual workflow editor. No setup required.
Get Started