PixVerse Platform Docs
  1. API Reference
PixVerse Platform Docs
  • Learn about PixVerse Platform
    • Introduce to PixVerse Platform
    • Quick Start
  • Getting started
    • How does the API work?
    • How to get API key?
    • How to check account balance?
    • How to subscribe API plans?
    • How to use Text-to-video
    • How to use Image-to-video
    • How to use Effects?
    • How to use Transition(First-last frame Feature)
    • How to get video generation status?
  • API Reference
    • API Parameter Description
    • Get user credit balance
      GET
    • Upload Image
      POST
    • Text-to-Video generation
      POST
    • Image-to-Video generation
      POST
    • Transition(First-last frame) generation
      POST
    • Get Video Generation Status
      GET
  • Trouble Shooting
    • Common errors and Solutions
    • Error codes
    • FAQ
  • Resources
    • Model & Pricing
    • Rate limit
    • Support
    • Change Logs
    • Term of Service
    • Privacy policy
  • PixVerse Tools
    • PixVerse MCP
  1. API Reference

Transition(First-last frame) generation

POST
/openapi/v2/video/transition/generate

Request

Header Params
Ai-Trace-Id
string 
required
Example:
{{$string.uuid}}
API-KEY
string 
required
Content-Type
string 
required
Example:
application/json
Body Params application/json
prompt
string 
required
Prompt
model
string 
required
Model version (now supports v3.5/v4/v4.5)
duration
integer 
required
Video duration (5, 8 seconds, --model=v3.5 only allows 5,8; --quality=1080p does not support 8s)
quality
string 
required
Video quality ("360p"(Turbo), "540p", "720p", "1080p")
motion_mode
string 
required
Motion mode (normal, fast, --fast only available when duration=5; --quality=1080p does not support fast)
seed
integer 
required
Random seed, range: 0 - 2147483647
first_frame_img
integer 
required
Image ID from Upload image API
last_frame_img
integer 
required
Image ID from Upload image API
Example
{
  "prompt": "transform into a puppy",
  "model": "v3.5",
  "duration": 5,
  "quality": "540p",
  "motion_mode": "normal",
  "seed": 937433858,
  "first_frame_img": 0,
  "last_frame_img": 0
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://app-api.pixverse.ai/openapi/v2/video/transition/generate' \
--header 'Ai-Trace-Id: {{$string.uuid}}' \
--header 'API-KEY;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "transform into a puppy",
    "model": "v3.5",
    "duration": 5,
    "quality": "540p",
    "motion_mode": "normal",
    "seed": 937433858,
    "first_frame_img": 0,
    "last_frame_img": 0
}'

Responses

🟢200Success
application/json
Body
ErrCode
integer 
optional
ErrMsg
string 
optional
Resp
object (dto.V2OpenAPII2VResp) 
optional
video_id
integer 
optional
Video_id
Example
{
  "ErrCode": 0,
  "ErrMsg": "string",
  "Resp": {
    "video_id": 0
  }
}
Previous
Image-to-Video generation
Next
Get Video Generation Status