Multi-Transition Video

POST

/openapi/v2/video/multi_transition/generate

Generate transitions between uploaded keyframes. Supply frames in order; each duration describes the segment leading to the next frame. For the final item, omit duration or set it to 0. Prompts must stay aligned with their corresponding segments.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Request processed. ErrCode=0 indicates business success; a nonzero ErrCode indicates failure, even with HTTP 200.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

Minimal request (replace resource IDs)Complete scenario (replace resource IDs)

curl --location 'https://app-api.pixverse.ai/openapi/v2/video/multi_transition/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
    "multi_transition": [
        {
            "img_id": 123456791,
            "duration": 3,
            "prompt": "The character turns around"
        },
        {
            "img_id": 123456790,
            "duration": 3,
            "prompt": "The camera moves closer"
        },
        {
            "img_id": 123456791,
            "duration": 0,
            "prompt": ""
        }
    ],
    "model": "v5",
    "quality": "360p",
    "motion_mode": "normal"
}'

Response Example

200 - Illustrative accepted task; poll to completion

{
    "ErrCode": 0,
    "ErrMsg": "Success",
    "Resp": {
        "video_id": 123456789,
        "credits": 10
    }
}

Reference-to-Video (Fusion)

Video Extend