PixVerse V6

Use pixverse-v6 to create video output. This page contains the complete request needed for this model.

Model facts

Property	Value
Model ID	`pixverse-v6`
Endpoint	`POST /api/v1/generation/create`
Output	Video
Modes	text-to-video, image-to-video
Pricing	View current pricing

Minimal request


curl -X POST https://api.api-stock.com/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "pixverse-v6",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}'

The create response contains a task ID:


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Parameters

Parameters belong inside the top-level input object. Unknown fields are rejected.

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	—	Video content description max 5000 chars
`resolution`	“360p” \| “540p” \| “720p” \| “1080p”	No	`"540p"`	Video resolution tier (affects pricing)
`duration`	number	No	`5`	Video duration in seconds (1-15). Transition mode only supports 5 or 8
`size`	“16:9” \| “4:3” \| “1:1” \| “3:4” \| “9:16” \| “2:3” \| “3:2” \| “21:9”	No	`"16:9"`	Video aspect ratio. Only effective in text-to-video and multi-reference fusion modes
`seed`	number	No	`0`	Random seed
`negativePrompt`	string	No	—	Negative prompt to exclude unwanted content max 2048 chars
`audio`	boolean	No	`false`	Whether to generate an audio track (increases pricing)
`watermark`	boolean	No	`false`	Whether to add a watermark in the bottom-right corner
`motionMode`	“normal”	No	—	Motion mode. pixverse-v6 only supports “normal”
`generateMultiClipSwitch`	boolean	No	`false`	Whether to generate a multi-clip continuous video. Only supported in text-to-video and image-to-video modes
`imageUrls`	string[]	No	—	Input image URL array for image-to-video mode (only the first image is used)
`firstFrameImage`	string	No	—	First frame image URL for transition mode. Must be provided together with lastFrameImage
`lastFrameImage`	string	No	—	Last frame image URL for transition mode. Must be provided together with firstFrameImage
`imgReferences`	string[]	No	—	Reference image URLs for multi-reference fusion mode (1-7 images)
`extendFromTaskId`	string	No	—	Source task ID for video extension mode

Modes

Minimal generation


{
  "model": "pixverse-v6",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}

With image urls


{
  "model": "pixverse-v6",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "imageUrls": [
      "https://example.com/input.jpg"
    ]
  }
}

With first frame image


{
  "model": "pixverse-v6",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "firstFrameImage": "https://example.com/input.jpg"
  }
}

With last frame image


{
  "model": "pixverse-v6",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "lastFrameImage": "https://example.com/input.jpg"
  }
}

Constraints

prompt: maximum 5000 characters.
resolution: allowed: 360p, 540p, 720p, 1080p.
size: allowed: 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9.
negativePrompt: maximum 2048 characters.
motionMode: allowed: normal.

Invalid types, unsupported enum values, out-of-range numbers, and missing required fields return HTTP 400 with error.code: "invalid_input". Correct the request rather than retrying it unchanged.

Result

Poll the task or provide a top-level webhook URL in the create request:


curl https://api.api-stock.com/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

A successful media task returns one or more files:


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://storage.api-stock.com/result.mp4",
        "fileType": "video"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

See Tasks and webhooks for terminal statuses, retries and webhook delivery.