PixVerse V6 API reference

Clips of 1 to 15 seconds up to 1080p, with transitions, references and extensions

Call PixVerse V6 from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.

At a glance

Made by: PixVerse
Output: Video
From: $0.023532 USD per second of output
Model IDs: pixverse/v6/text-to-video
pixverse/v6/image-to-video
pixverse/v6/reference-to-video
pixverse/v6/video-extend

Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.

Create Video

pixverse/v6/text-to-video

Price

Option	USD
`generate_audio = false, resolution = 360p`	$0.023532 per second of output
`generate_audio = false, resolution = 540p`	$0.032966 per second of output
`generate_audio = true, resolution = 360p`	$0.032966 per second of output
`generate_audio = false, resolution = 720p`	$0.0424 per second of output
`generate_audio = true, resolution = 540p`	$0.0424 per second of output
`generate_audio = true, resolution = 720p`	$0.056498 per second of output
`generate_audio = false, resolution = 1080p`	$0.0848 per second of output
`generate_audio = true, resolution = 1080p`	$0.108332 per second of output

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	Describe the subject, the action and the camera.
`aspect_ratio`Optional	`string`	`16:9`	16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9	Output aspect ratio.
`resolution`Optional	`string`	`720p`	360p, 540p, 720p, 1080p	Output resolution. Higher tiers cost more per second.
`duration_seconds`Optional	`integer`	`5`	1 to 15	Clip length in whole seconds, 1 to 15. Billed per second.
`generate_audio`Optional	`boolean`	`false`	—	Generate sound with the picture. Costs more per second when on.
`shot_type`Optional	`string`	`single`	single, multi	single keeps one continuous shot; multi lets the model cut the clip into several shots.
`seed`Optional	`integer`	—	0 to 2147483647	Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "pixverse/v6/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "generate_audio": false,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Image to Video

pixverse/v6/image-to-video

Price

Option	USD
`generate_audio = false, resolution = 360p`	$0.023532 per second of output
`generate_audio = false, resolution = 540p`	$0.032966 per second of output
`generate_audio = true, resolution = 360p`	$0.032966 per second of output
`generate_audio = false, resolution = 720p`	$0.0424 per second of output
`generate_audio = true, resolution = 540p`	$0.0424 per second of output
`generate_audio = true, resolution = 720p`	$0.056498 per second of output
`generate_audio = false, resolution = 1080p`	$0.0848 per second of output
`generate_audio = true, resolution = 1080p`	$0.108332 per second of output

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	What happens after the first frame, or between the first and last frame.
`image_url`Required	`string (uri)`	—	—	First frame. JPG, PNG or WebP up to 20 MB; the clip's aspect ratio follows this image.
`last_image_url`Optional	`string (uri)`	—	—	Optional last frame: the clip moves from the first image to this one.
`resolution`Optional	`string`	`720p`	360p, 540p, 720p, 1080p	Output resolution. Higher tiers cost more per second.
`duration_seconds`Optional	`integer`	`5`	1 to 15	Clip length in whole seconds, 1 to 15. Billed per second.
`generate_audio`Optional	`boolean`	`false`	—	Generate sound with the picture. Costs more per second when on.
`shot_type`Optional	`string`	`single`	single, multi	single keeps one continuous shot; multi lets the model cut the clip into several shots.
`seed`Optional	`integer`	—	0 to 2147483647	Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in image_url. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "pixverse/v6/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_audio": false,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Reference to Video

pixverse/v6/reference-to-video

Price

Option	USD
`generate_audio = false, resolution = 360p`	$0.023532 per second of output
`generate_audio = false, resolution = 540p`	$0.032966 per second of output
`generate_audio = true, resolution = 360p`	$0.032966 per second of output
`generate_audio = false, resolution = 720p`	$0.0424 per second of output
`generate_audio = true, resolution = 540p`	$0.0424 per second of output
`generate_audio = true, resolution = 720p`	$0.056498 per second of output
`generate_audio = false, resolution = 1080p`	$0.0848 per second of output
`generate_audio = true, resolution = 1080p`	$0.108332 per second of output

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	Describe the shot and place each reference with @name.
`elements`Required	`array<object>`	—	up to 7 items	One to seven named references. Write @name in the prompt, followed by a space, where each should appear.
`aspect_ratio`Optional	`string`	`16:9`	16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9	Output aspect ratio.
`resolution`Optional	`string`	`720p`	360p, 540p, 720p, 1080p	Output resolution. Higher tiers cost more per second.
`duration_seconds`Optional	`integer`	`5`	1 to 15	Clip length in whole seconds, 1 to 15. Billed per second.
`generate_audio`Optional	`boolean`	`false`	—	Generate sound with the picture. Costs more per second when on.
`seed`Optional	`integer`	—	0 to 2147483647	Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in elements. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "pixverse/v6/reference-to-video",
  "input": {
    "prompt": "@hero walks along a quiet beach at sunset, smiling at the camera. Slow dolly back.",
    "elements": [
      {
        "image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
        "name": "hero",
        "role": "subject"
      }
    ],
    "generate_audio": false,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Extend Video

pixverse/v6/video-extend

Price

Option	USD
`generate_audio = false, resolution = 360p`	$0.023532 per second of output
`generate_audio = false, resolution = 540p`	$0.032966 per second of output
`generate_audio = true, resolution = 360p`	$0.032966 per second of output
`generate_audio = false, resolution = 720p`	$0.0424 per second of output
`generate_audio = true, resolution = 540p`	$0.0424 per second of output
`generate_audio = true, resolution = 720p`	$0.056498 per second of output
`generate_audio = false, resolution = 1080p`	$0.0848 per second of output
`generate_audio = true, resolution = 1080p`	$0.108332 per second of output

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	What happens next.
`video_url`Required	`string (uri)`	—	—	The clip to continue. The result is this clip followed by the new seconds, in one file.
`resolution`Optional	`string`	`720p`	360p, 540p, 720p, 1080p	Output resolution. Higher tiers cost more per second.
`duration_seconds`Optional	`integer`	`5`	1 to 15	New seconds to add, 1 to 15. Only these seconds are billed.
`generate_audio`Optional	`boolean`	`false`	—	Generate sound with the picture. Costs more per second when on.
`seed`Optional	`integer`	—	0 to 2147483647	Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in video_url. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "pixverse/v6/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "generate_audio": false,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

PixVerse V6 API reference

At a glance

Create Video

Price

Parameters

Example request

Image to Video

Price

Parameters

Example request

Reference to Video

Price

Parameters

Example request

Extend Video

Price

Parameters

Example request

Next steps

On this page