Transition(First-last frame) generation

POST

/openapi/v2/video/transition/generate

Request

Header Params

Ai-Trace-Id

string

required

Example:

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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
  }
}

Image-to-Video generation

Get Video Generation Status