Get Effect Template List

GET

/openapi/v2/video/effects/templates/list

Query traditional effect templates and workflow templates to retrieve a list of template details, including input requirements, supported resolutions, and credit configuration.

Request

Query Params

Header Params

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

curl --location 'https://app-api.pixverse.ai/openapi/v2/video/effects/templates/list?type=&template_ids=&page=&pageSize=&%20template_mode=undefined' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Accept-Language;'

Response Example

200 - Illustrative template metadata, not a fixed catalog

{
    "ErrCode": 0,
    "ErrMsg": "Success",
    "Resp": {
        "effect_items": [
            {
                "template_id": 424590596481004,
                "display_name": "Disco Fever ’80s",
                "display_prompt": "Step onto the dance floor, spin to the beat, and light up the night in pure ’80s disco style.",
                "thumbnail_video_url": "https://media.pixverse.ai/canvas%2Fasset%2F6b93ceb5-c02b-46b9-89c9-337f19c83566.mp4",
                "qualities": [],
                "effect_type": "1",
                "effect_length": [
                    5
                ],
                "topic_requirements": "1",
                "type": 1,
                "create_at": "2026-09-16 08:04:00",
                "credit_consume": [
                    {
                        "consume_desc_key": "360p",
                        "credit": "115"
                    },
                    {
                        "consume_desc_key": "540p",
                        "credit": "115"
                    },
                    {
                        "consume_desc_key": "720p",
                        "credit": "115"
                    },
                    {
                        "consume_desc_key": "1080p",
                        "credit": "115"
                    }
                ],
                "template_mode": "workflow",
                "template_source": 21,
                "canvas_image_count": 1,
                "input_limit": [
                    {
                        "input_key": "image-98114284-c3b9-46c1-a693-516b96d11357",
                        "content_type": "image",
                        "name": "Generate a European-style half-body portrait of a female, with a simple, sophisticated, and bright background. Style: 清_GPT Image 2_1080p (7)",
                        "max_size": 31457280
                    }
                ],
                "outputs": [
                    {
                        "content_type": "video"
                    }
                ]
            }
        ]
    }
}

Verify Uploaded Audio

Get TTS Speaker List