Get Available Video Effects

April 18, 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"
  },
  {
    "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"
  }
]

  • 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.

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")
  compositedSchema?: {  // Only present for effects that support tail images and prompts
    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
  • Effects with a compositedSchema may require additional parameters:
    • Some effects require both an image and an image_tail parameter
    • Some effects require a specific prompt parameter
  • 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