Reference-to-Video (Fusion)

POST

/openapi/v2/video/fusion/generate

Image references and video references share this endpoint. Video references require model=v6, reference_mode=omni, and duration=0. Up to 2 reference videos with combined duration no greater than 15 seconds; output duration follows the longest reference. V6 Omni supports up to 10 image references. Image-only mode supports the listed compatible models subject to account access. At least one nonempty reference collection is required.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful response.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

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

curl --location 'https://app-api.pixverse.ai/openapi/v2/video/fusion/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image_references": [
        {
            "type": "subject",
            "img_id": 123456791,
            "ref_name": "robot"
        },
        {
            "type": "subject",
            "img_id": 123456790,
            "ref_name": "companion"
        }
    ],
    "prompt": "@robot meets @companion with soft cinematic lighting",
    "model": "v6",
    "duration": 5,
    "quality": "720p",
    "aspect_ratio": "16:9"
}'

Response Example

200 - Illustrative accepted task; poll to completion

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

First and Last Frame Video

Multi-Transition Video