Retrieve the list of effects

December 6, 2024 (January 8, 2026)

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

The returned effect_type field indicates the number of images required for a given effect:

  • "1" = single image (e.g., face swap, dance effects)
  • "2" = two images (e.g., hug, kiss effects)

The total credit cost for a template is video_base_cost + fixed_cost.

https://api.useapi.net/v2/pixverse/videos/effects?…

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
Query Parameters
  • email is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.
Responses

  • 200 OK

    {
    "items": [
        {
            "template_id": 380178461924416,
            "display_name": "Miniature Nail Artist Live",
            "workflow_tag": "meta_nanopro_it2v_v5_251204",
            "display_prompt": "Watch your 3D figurine create gorgeous nail designs!",
            "effect_type": "1",
            "template_type": 1,
            "duration": 5,
            "qualities": ["360p", "540p", "720p", "1080p"],
            "video_base_cost": 20,
            "fixed_cost": 20,
            "example_text": "Upload a person photo",
            "thumbnail_path": "https://media.pixverse.ai/…png",
            "thumbnail_video_path": "https://media.pixverse.ai/…mp4",
            "thumbnail_gif_path": "https://media.pixverse.ai/…gif",
            "audio_path": "https://media.pixverse.ai/…mp3",
            "marker": "new"
        },
        {
            "template_id": 326733946317888,
            "display_name": "Hug Together",
            "workflow_tag": "interact_hug_250529",
            "display_prompt": "Create a heartwarming hug moment",
            "effect_type": "2",
            "template_type": 1,
            "duration": 5,
            "qualities": ["360p", "540p", "720p", "1080p"],
            "video_base_cost": 20,
            "fixed_cost": 0,
            "example_text": "Upload a two-person photo",
            "thumbnail_path": "https://media.pixverse.ai/…png",
            "thumbnail_video_path": "https://media.pixverse.ai/…mp4",
            "thumbnail_gif_path": "https://media.pixverse.ai/…gif",
            "audio_path": "https://media.pixverse.ai/…mp3",
            "marker": "hot"
        }
    ],
    "total": 150,
    "next_offset": 0
}

  • 400 Bad Request

    {
    "error": "<Error message>",
    "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}
Model 
{   // TypeScript, all fields are optional
  items: {
    template_id: number
    display_name: string
    workflow_tag: string
    display_prompt: string
    effect_type: string       // "1" = single image, "2" = two images required
    template_type: number     // 1 = video template
    duration: number          // video duration in seconds (5 or 8)
    qualities: string[]       // available quality options
    video_base_cost: number   // base credit cost
    fixed_cost: number        // template-specific extra cost (0 for basic, 20 for premium)
    example_text: string      // usage hint (e.g., "Upload a person photo")
    thumbnail_path: string
    thumbnail_video_path: string
    thumbnail_gif_path: string
    audio_path: string
    marker: string            // "new", "hot", or ""
  }[]
  total: number
  next_offset: number
}
Examples 
  • curl "https://api.useapi.net/v2/pixverse/videos/effects?email=email" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

  • const token = "API token";
const email= "Previously configured account email"; 
const apiUrl = `https://api.useapi.net/v2/pixverse/videos/effects?email=${email}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
email= "Previously configured account email"
apiUrl = f"https://api.useapi.net/v2/pixverse/videos/effects?email={email}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It