Skip to main content
POST
PixVerse C1 Reference to Video

Authorizations

Authorization
string
header
required

All APIs require Bearer Token authentication

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json
model
string
default:pixverse-c1-reference-to-video
required

pixverse-c1-reference-to-video: Reference to video, supports subject consistency

Example:

"pixverse-c1-reference-to-video"

prompt
string
required

Text prompt describing the desired video content

Notes:

  • Supports both Chinese and English
  • Recommended to clearly describe subject, action, scene, and camera language
Example:

"A cinematic dolly shot through a neon cyberpunk alley at night"

references
object[]
required

Reference image list

Notes:

  • Each element contains url (image URL), type (reference type), ref_name (reference name)
  • Used to guide the generation of specific subjects or styles in the video
Example:
resolution
string
default:720p

Output video resolution

Options:

  • 540p
  • 720p — Default
Example:

"540p"

duration
integer
default:5

Output video duration in seconds

Notes:

  • Supports 1 to 15 seconds
  • Defaults to 5 seconds
Example:

5

generate_audio
boolean
default:false

Whether to generate accompanying audio

Notes:

  • When enabled, can generate background sounds, sound effects, or dialogue
  • Disabled by default
Example:

false

negative_prompt
string | null

Negative prompt describing unwanted elements

Notes:

  • Multiple keywords can be separated by commas

Not required; omit this parameter unless needed.

Example:

"blurry, low quality, watermark"

seed
integer | null

Random seed

Notes:

  • Same parameters with the same seed can improve result reproducibility
  • Random if not specified

Not required; omit this parameter unless needed.

Example:

42

Response

Task created successfully

created
integer

Task creation timestamp

Example:

1757165031

id
string

Task ID

Example:

"task-unified-1757165031-uyujaw3d"

model
string

Actual model name used

object
enum<string>

Specific task type

Available options:
video.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object

Asynchronous task information

type
enum<string>

Task output type

Available options:
video
Example:

"video"