Video Expand

POST

/openapi/v2/video/expand/generate

Generate content around a source video's frame to fit a target aspect ratio. Provide exactly one source ID. Source video: MP4/MOV/WebM, up to 30 seconds / 50 MB. Output quality: 720p or 1080p. Returns a new task ID.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

ErrCode=0 means the task was accepted; a nonzero value means the request failed.

Bodyapplication/json

🟠400

Request Example

Shell

Generated video source (replace resource ID)Uploaded video source (replace resource ID)

curl --location 'https://app-api.pixverse.ai/openapi/v2/video/expand/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
    "source_video_id": 123456789,
    "aspect_ratio": "16:9",
    "quality": "720p"
}'

Response Example

200 - Accepted task: 10-second input at 720p; ID is illustrative

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

Video Extend

Image Template Generation