Video Source

To submit a video via API, you need to have an URL to that video first. Vizard supports video URLs from multiple sources, you need to set both videoUrl and corresponding videoType in a request.

🔢 Parameter Values and Meanings:

❗️The maximum video length is 600 minutes, with a file size limit of 10GB. The highest supported upload resolution is 4K, and exported clips will maintain the same resolution as the original long video.

Clip Length

Clip length refers to the target length of each short video generated by Vizard from your original long-form content. The parameter preferLength controls how long each output video will be, which impacts where and how you might want to use the clips:

• Short clips (<30s) are great for TikTok or quick highlights.
• Medium-length clips (30–60s) work well for Instagram Reels or YouTube Shorts.
• Longer clips (1–3 minutes) are ideal for in-depth commentary, tutorials, or thought leadership posts on platforms like LinkedIn or Twitter.

🔢 Parameter Values and Meanings:

Usage Examples:

• ✅ preferLength: [1] → Generate only ultra-short clips (<30s)
• ✅ preferLength: [2,3] → Generate medium-length clips (30s–90s)
• ✅ preferLength: [1,2,3] → Generate a variety of clips under 90s
• ✅ preferLength: [0] → Let AI automatically decide the best duration per clip

Please note that the preferred clip length can be set to 0 for auto mode, or as a specific length range—for example, [1, 2] allows clips shorter than 30 seconds and those between 30 and 60 seconds. However, 0 (auto mode) cannot be combined with other values, so an array like [0, 1] is invalid.

Spoken Language

The lang parameter tells Vizard what spoken language is used in your submitted video. This helps the AI model accurately transcribe, generate subtitles, and detect meaningful highlights based on speech and keywords.

Setting this value to auto can be a good choice for most of use cases cause our AI will auto detect and recognize the spoken language in your video. Vizard supports a growing number of languages using standard ISO 639-1 language codes. For the list of supported languages and language codes, please refer to Supported Languages .

🔢 Parameter Values and Meanings:

Example Request

Example request with the minimum required parameters to send your video.

curl -X POST https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/create \
  -H "Content-Type: application/json" \
  -H "VIZARDAI_API_KEY: YOUR_API_KEY" \
  -d '{
    "lang": "en",
    "preferLength": [0],
    "videoUrl": "https://www.youtube.com/watch?v=OqLfw-TzzfI",
    "videoType": 2
  }'

import requests

headers = {
    "Content-Type": "application/json",
    "VIZARDAI_API_KEY": "YOUR_API_KEY"
}

data = {
    "lang": "en",
    "preferLength": [0],
    "videoUrl": "https://www.youtube.com/watch?v=OqLfw-TzzfI",
    "videoType": 2
}

response = requests.post(
    "https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/create",
    headers=headers,
    json=data
)

print(response.json())

import axios from 'axios';

const headers = {
  'Content-Type': 'application/json',
  'VIZARDAI_API_KEY': 'YOUR_API_KEY'
};

const payload = {
  lang: 'en',
  preferLength: [0],
  videoUrl: 'https://www.youtube.com/watch?v=OqLfw-TzzfI',
  videoType: 2
};

axios.post('https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/create', payload, { headers })
  .then(res => console.log(res.data))
  .catch(err => console.error(err));