Generate（Multi-Subject Reference）

POST

/pix/generate

Video generation model from PixVerse, multi-subject reference
Subject reference fusion supports up to 3 images
Use @1 (first image) / @2 (second image) / @3 (third image) in the prompt to describe different subjects

Base price: 0.1 PTC / per use

Parameter Type	Parameter Value	Price Multiplier
Video Quality quality	360p	×1
	540p	×1.5
	720p	×2
	1080p	×4
Video Duration duration	5s	×1
	8s	×2
Motion Mode motion_mode	normal	×1
	fast	×2

720p does not support selecting both fast mode and 8s duration at the same time; 1080p does not support selecting fast mode or 8s duration

The price multiplier is dynamically calculated based on the request parameters. Multipliers for multiple parameters are multiplied together.
For example: The price for a 720p 8s video is 0.1x2x2=0.4

Request

Header Params

Body Params application/json

Examples

特效模式首尾帧

{
    "model": "v4.5",
    "prompt": "@1 hug @2 .",
    "fusion": [
        "",
        ""
    ],
    "aspect_ratio": "16:9"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

特效模式首尾帧

curl --location --request POST 'https://api.302.ai/pix/generate' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "v4.5",
    "prompt": "@1 hug @2 .",
    "fusion": [
        "",
        ""
    ],
    "aspect_ratio": "16:9"
}'

Responses

🟢200成功

application/json

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "pix_4a2444a64814"
    }
}

Modified at 2025-08-28 05:55:39

Generate（Image-to-Video Generation）

Fetch