PixVersevideoBest valueOperational

PixVerse V6 Reference to Video API

Name: PixVerse V6 API
Brand: PixVerse
Availability: InStock

Reference to Video with PixVerse V6 by PixVerse. Creator-favorite effects and styles, from 2 cents a second.

pixverse/pixverse-v6/reference-to-video

FromUp to −20%

$0.018/s$0.022

per second of video · 360p

Open in Studio API

Try PixVerse V6 Reference to Video

Prompt*

Type @ to point at a reference image0/5000

Reference images*

Up to 7 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2…

Aspect ratio

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (1–15s). You pay per second.

Generate audio

Generate synchronized sound, ambience and dialogue. Clips with audio are billed at a higher per-second rate.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: PixVerse V6 Text to Video · PixVerse V6 Image to Video

PixVerse V6 Reference to Video API

POST/api/v1/run/pixverse/pixverse-v6/reference-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`reference_image_urls`required	string[] (URLs)	Up to 7 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… Max items: 7	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 360p · 540p · 720p · 1080p Default: 540p	Yes
`duration`	integer	Length of the generated clip in seconds (1–15s). You pay per second. Range: 1–15s Default: 5	Yes
`generate_audio`	boolean	Generate synchronized sound, ambience and dialogue. Clips with audio are billed at a higher per-second rate. Default: false	Yes
`negative_prompt`	string	Things to avoid in the output.	No
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

curl -X POST https://cheapergen.com/api/v1/run/pixverse/pixverse-v6/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "The character from @Image1 skateboards past the mural in @Image2, dynamic tracking shot",
  "reference_image_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.jpg",
    "https://cdn.cheapergen.ai/samples/reference-2.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "540p",
  "duration": 5
}'

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/pixverse/pixverse-v6/reference-to-video", headers=headers, json={
    "prompt": "The character from @Image1 skateboards past the mural in @Image2, dynamic tracking shot",
    "reference_image_urls": [
        "https://cdn.cheapergen.ai/samples/reference-1.jpg",
        "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "540p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/pixverse/pixverse-v6/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "The character from @Image1 skateboards past the mural in @Image2, dynamic tracking shot",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "540p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "pixverse/pixverse-v6",
  "endpoint": "pixverse/pixverse-v6/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "The character from @Image1 skateboards past the mural in @Image2, dynamic tracking shot",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "540p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "pixverse/pixverse-v6",
  "endpoint": "pixverse/pixverse-v6/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "The character from @Image1 skateboards past the mural in @Image2, dynamic tracking shot",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "540p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.ai/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

PixVerse V6 pricing

Pay per second of video. No subscription. Failed generations are refunded automatically.

Tier	Official price	Cheaper Gen.	You save
360p silent	~~$0.022~~/s	$0.018/s	−20%
360p + audio with audio	~~$0.031~~/s	$0.026/s	−15%
540p silent	~~$0.031~~/s	$0.026/s	−15%
540p + audio with audio	~~$0.04~~/s	$0.035/s	−12%
720p silent	~~$0.04~~/s	$0.035/s	−12%
720p + audio with audio	~~$0.053~~/s	$0.044/s	−17%
1080p silent	~~$0.08~~/s	$0.07/s	−12%
1080p + audio with audio	~~$0.102~~/s	$0.088/s	−14%

Official price: PixVerse platform API list price for V6 (225 credits = $1; per second 360p $0.022 / $0.031 with audio, 540p $0.031 / $0.040, 720p $0.040 / $0.053, 1080p $0.080 / $0.102). Prices verified 2026-10-16.

About PixVerse V6 All PixVerse V6 endpoints