Image-to-Video and Video Templates

POST

/openapi/v2/video/img/generate

Generate from an uploaded image, or use template_id for a template-based task. Normal image generation requires img_id. For templates, provide the image field and count required by that template (img_id or ordered img_ids). Template metadata determines supported model, duration, and quality; do not assume every template accepts the same combination.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

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)

curl --location 'https://app-api.pixverse.ai/openapi/v2/video/img/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
    "duration": 5,
    "img_id": 123456790,
    "model": "v6",
    "prompt": "Make the subject walk forward slowly.",
    "quality": "720p",
    "generate_audio_switch": false,
    "seed": 0
}'

Response Example

200 - Illustrative accepted task; poll to completion

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

Text-to-Video

First and Last Frame Video