PixVerse V6 First & Last Frame Transition
Endpoint
POST /videos/generations
Full URL: https://modelfold.ai/v1/videos/generations
Authentication: every request must include the
Authorization: Bearer <API_KEY>header.
Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.
Input parameters for the generation task
Request Parameters
Body (application/json)
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | The name of the model used for the generation task. Required field. Default:"pixverse-v6/transition"。 Allowed values:pixverse-v6/transition。 Example:pixverse-v6/transition。 |
prompt | string | Yes | Prompt required by the ModelFold gateway; at most 2000 characters. Generate prompt, cannot be empty, length is limited to 3-5000 characters. minLength: 3. maxLength: 2000. Example:A cinematic sunrise illuminates a mist-shrouded mountain lake; the camera slowly sweeps across the water's surface as a flock of birds flies overhead.。 |
first_frame_image_url | string | Yes | First frame image URL. Supports HTTP, HTTPS, and OSS addresses; supported image formats include JPG, JPEG, PNG, and WebP; the size of a single image file must not exceed 20 MB Example:https://your-domain.com/images/first-frame.png。 |
last_frame_image_url | string | Yes | Last frame image URL. Supports HTTP, HTTPS, and OSS addresses; supported image formats include JPG, JPEG, PNG, and WebP; the size of a single image file must not exceed 20 MB Example:https://your-domain.com/images/last-frame.png。 |
quality | string | Yes | Required. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Allowed values:360p / 540p / 720p / 1080p。 Example:720p。 |
duration | integer | Yes | Required. Output video duration in seconds. PixVerse V6 supports 1–15 seconds. minimum: 1. maximum: 15. Example:5。 |
generate_audio_switch | boolean | No | Whether to generate audio synchronized with the video content. Default:false。 Example:false。 |
seed | integer | No | Random seed, value range is 0–2147483647. Using the same parameters and seed helps improve result reproducibility. minimum: 0. maximum: 2147483647. Example:123456789。 |
Request Example
bash
curl -X POST "https://modelfold.ai/v1/videos/generations" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6/transition",
"prompt": "A cinematic sunrise illuminates a mist-shrouded mountain lake; the camera slowly sweeps across the water'\''s surface as a flock of birds flies overhead.",
"first_frame_image_url": "https://your-domain.com/images/first-frame.png",
"last_frame_image_url": "https://your-domain.com/images/last-frame.png",
"quality": "720p",
"duration": 5,
"generate_audio_switch": false
}'json
{
"model": "pixverse-v6/transition",
"prompt": "A cinematic sunrise illuminates a mist-shrouded mountain lake; the camera slowly sweeps across the water's surface as a flock of birds flies overhead.",
"first_frame_image_url": "https://your-domain.com/images/first-frame.png",
"last_frame_image_url": "https://your-domain.com/images/last-frame.png",
"quality": "720p",
"duration": 5,
"generate_audio_switch": false
}Response
200 — Generation completed. usage contains actual billing details; result URLs are illustrative.
json
{
"ok": true,
"created": 1792134000,
"data": [
{
"url": "https://modelfold.ai/uploads/outputs/result.mp4"
}
],
"usage": {}
}