POST
/
clip
Request video processing
curl --request POST \
  --url https://mango.quickreel.io/api/v2/clip \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "videoUrl": "https://www.youtube.com/watch?v=eY4pgeNBhk4",
  "language": "english",
  "webhookUrl": "https://webhook-test.com/05674b0b229c29199fec105309a00e16",
  "subtitleStyles": {
    "template": "productive",
    "position": "bottom-center",
    "fontSize": "m"
  },
  "additionalFeatures": {
    "addBgm": "false",
    "addBroll": false,
    "removeFillerWords": "false",
    "removeSilenceParts": "false",
    "addHook": "false"
  },
  "clipSettings": {
    "reelsCount": 123,
    "prompt": "A viral video about the benefits of using our product",
    "keywords": [
      "product",
      "benefits",
      "features"
    ],
    "reelDuration": "<string>"
  },
  "brollSettings": {
    "type": "images",
    "frequency": "none"
  },
  "bgmSettings": {
    "url": "<string>",
    "volume": 123,
    "fadeIn": 123,
    "fadeOut": 123
  }
}'
{
  "status": "created",
  "message": "project created successfully",
  "projectId": "667bbc6973e392d3f7f6f620"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Request payload for video processing

​
videoUrl
string
required

Video URL or YouTube URL

Example:

"https://www.youtube.com/watch?v=eY4pgeNBhk4"

​
language
enum<string>
required

Preferred language for subtitles

Available options:
bulgarian,
catalan,
chinese (mandarin, simplified),
chinese (mandarin, traditional),
czech,
danish,
dutch,
english,
estonian,
finnish,
flemish,
french,
german,
german (switzerland),
greek,
hindi,
hungarian,
indonesian,
italian,
japanese,
korean,
latvian,
lithuanian,
malay,
multilingual (spanish + english),
norwegian,
polish,
portuguese,
romanian,
russian,
slovak,
spanish,
swedish,
thai,
turkish,
ukrainian,
vietnamese,
hinglish
Example:

"english"

​
webhookUrl
string
required

Webhook URL for receiving processing updates

Example:

"https://webhook-test.com/05674b0b229c29199fec105309a00e16"

​
subtitleStyles
object

Subtitle styles for the video (optional)

​
additionalFeatures
object

Additional features for the video (optional)

​
clipSettings
object

Settings for clip generation (optional)

​
brollSettings
object

Settings for B-roll footage (optional)

​
bgmSettings
object

Settings for background music (optional)

Response

Request created successfully

​
status
string

Status of the request

Example:

"created"

​
message
string

Success message

Example:

"project created successfully"

​
projectId
string

Project ID

Example:

"667bbc6973e392d3f7f6f620"