PixVerse V6 API

About PixVerse V6

pixverse/v6/reference-to-video builds the shot from elements rather than from a first frame. Each element carries a name of 1 to 30 characters, one image_url and a role of subject or background.

Call it with the model name pixverse/v6/reference-to-video on POST /jobs/createTask, from $0.111.

Introduction

PixVerse V6 Reference to video casts a clip from pictures you send, up to 7 elements in one request. PixVerse calls this mode Fusion. Each element has a name, one picture and a role: subject for a person, animal, object or product, or background for a place or setting. Write @name in the prompt where each element should appear. Clips run 1 to 15 seconds at 360p to 1080p, in eight aspect ratios.

Choose a PixVerse V6 mode by starting material

Key features

Name your elements

Give each element a name of 1 to 30 characters and call it with @name in the prompt. In our test maya (a photo of a red-haired woman in a mustard jacket) and trailer (a photo of a chrome travel trailer) became a dusk shot of her walking toward the camera with a steaming enamel mug in front of the trailer, string lights on. Her face, hair and jacket matched the reference and so did the trailer.

Put a space after the name

In our test "@trailer," with a comma right after the name was rejected because the name did not match, while "@trailer and" worked. Write @name followed by a space.

Subjects and backgrounds

Set role to subject (default) for people, animals, objects and products, or to background for a place. One request can mix up to 7 of them.

Small artifacts happen

In our sample one frame showed a second figure briefly in the doorway. Check the clip before you ship it.

Request parameters

Pricing

Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

Put a person in a place they were never photographed

A portrait as one element and a photo of a location as a background, with the action written in the prompt.

Keep a vehicle or product consistent

Give a car, a trailer or a product its own element so it matches its photo in every clip you make.

Cast a short scene

Name two or three elements, say how they meet, and add a camera move.

Prompt guide & pro tips

Open with the action, name the elements as you go

Our prompt reads: "At blue hour in the high desert, @maya steps out of the door of @trailer and stretches, then walks toward the camera..." Each @name sits where that element appears in the story.

One clear picture per element

Each element takes one picture of one subject or place. Mark a setting such as a room, a street or a landscape with role: background, and people, animals, vehicles and products with the default subject, so the model treats the place as the scene rather than as something to put into it.

Compare with a seed

seed keeps runs comparable while you change one thing at a time. It does not guarantee identical frames.

API quick start

Call the PixVerse V6 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
2. Send the request. POST /jobs/createTask with model pixverse/v6/reference-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "pixverse/v6/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
      }
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

About the PixVerse V6 Reference to Video endpoint

Call each element by its name in the prompt, written as @name followed by a space. In our tests a comma directly after the name was rejected, so keep a space after every name you use.

aspect_ratio is available here, with 16:9 as the default. Choose it on each request, because no starting frame sets the shape of a reference clip.

Keep the element photos clear and well lit. Blurred or very small references give the model little to match, and the character can drift between clips.

PixVerse V6 API questions

More about PixVerse V6

Try it

PixVerse V6 AI Video Generator onlineCreate videos with PixVerse V6 in PopNow

Endpoints

All PixVerse V6 endpoints and pricing

Endpoints

PixVerse V6 · Create VideoPixVerse V6 · Image to VideoPixVerse V6 · Extend Video

Docs

PixVerse V6 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get PixVerse V6 results without polling