Get Available Video Effects

April 18, 2025 (July 25, 2025)

Table of contents

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

This endpoint retrieves a list of available special effects that can be applied to videos when using the POST /videos/image2video-effects endpoint.

https://api.useapi.net/v1/kling/videos/effects/?…

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

    [
      {
        "name": "rocket",
        "caption": "RocketRocket",
        "hot": true,
        "minimalKrnVersion": 20250416,
        "supportedModelMode": ["std", "pro"],
        "compositedSchema": {
          "preprocess": {
            "taskType": "",
            "taskVersion": "",
            "defaultPrompt": "",
            "requireInputs": [
              {
                "inputType": "URL",
                "contentType": "IMAGE",
                "optional": false,
                "contentName": "image"
              }
            ]
          },
          "process": {
            "taskType": "m2v_img2video_se_hq",
            "taskVersion": "1.6",
            "defaultPrompt": "emits dazzling white smoke and orange Mach rings from the bottom, and it begins to rise into the air...",
            "requireInputs": [
              {
                "inputType": "URL",
                "contentType": "IMAGE",
                "optional": false,
                "contentName": "image"
              }
            ]
          }
        },
        "videoUrl": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/kling/ai_se/火箭升空-原-海-视频.gif",
        "coverUrl": "https://s21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/kling/ai_se/火箭升空-原-海-封面.jpg",
        "webVideoUrl": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/kling/ai_se/火箭升空-原-海-视频.mp4",
        "effectSupported": true,
        "promptSupported": true
      },
      {
        "name": "spinoff",
        "caption": "DizzyDizzy",
        "hot": false,
        "minimalKrnVersion": 400,
        "supportedModelMode": ["pro"],
        "videoUrl": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/kling/ai_se/魔力转圈圈-视频.gif",
        "coverUrl": "https://s21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/kling/ai_se/魔力转圈圈-封面.png",
        "webVideoUrl": "https://v21-kling.klingai.com/bs2/upload-ylab-stunt-sgp/kling/ai_se/魔力转圈圈-视频-compress.mp4",
        "effectSupported": false,
        "promptSupported": false
      }
    ]
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    

The response contains an array of available effects that can be used with the POST /videos/image2video-effects endpoint.

Each effect now includes additional flags:

  • effectSupported: Indicates if the effect is supported by the current endpoint (false means it requires image preprocessing)
  • promptSupported: Indicates if the effect accepts custom prompts (false means it uses only default prompts)
Model
{ // TypeScript, all fields are optional
  name: string          // Effect name identifier (used in requests)
  caption: string       // Display name for the effect
  hot: boolean          // Whether this is a featured effect
  minimalKrnVersion?: number // Minimum kernel version required
  supportedModelMode?: string[] // Supported model modes ("std", "pro")
  effectSupported?: boolean // Whether effect is supported (false = requires preprocessing)
  promptSupported?: boolean // Whether effect accepts custom prompts
  compositedSchema?: {  // Legacy schema information
    preprocess?: {
      taskType: string
      taskVersion: string
      defaultPrompt: string
      requireInputs: Array<{
        inputType: string
        contentType: string
        optional: boolean
        contentName: string
      }>
    }
    process?: {
      taskType: string
      taskVersion: string
      defaultPrompt: string
      requireInputs: Array<{
        inputType: string
        contentType: string
        optional: boolean
        contentName: string
      }>
    }
  }
  videoUrl: string      // Preview video URL for the effect
  coverUrl: string      // Cover image URL for the effect
  webVideoUrl: string   // Web-optimized preview video URL
}
Usage Notes
  • effectSupported: Only effects with effectSupported: true can be used with the POST /videos/image2video-effects endpoint
  • promptSupported: Effects with promptSupported: true accept custom prompts; others use built-in defaults
  • supportedModelMode: Check which quality modes (std/pro) are available for each effect
  • Use the effect’s name value when making requests to the POST /videos/image2video-effects endpoint
Examples
  • curl -X GET "https://api.useapi.net/v1/kling/videos/[email protected]" \
       -H "Authorization: Bearer …"
    
  • const token = "API token";
    const email = "Previously configured account email";
    const apiUrl = "https://api.useapi.net/v1/kling/videos/effects"; 
    const response = await fetch(`${apiUrl}?email=${email}`, {
      method: "GET",
      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 = "https://api.useapi.net/v1/kling/videos/effects"
    headers = {
        "Authorization" : f"Bearer {token}"
    }
    params = {
        "email": email
    }
    response = requests.get(apiUrl, headers=headers, params=params)
    print(response, response.json())
    
Try It