Shorts

Generate viral shorts from a long video

Turns one long video into ranked, ready-to-post clips with hooks + virality scores, 9:16 by default (format picks 4:5, 1:1 or 16:9). Provide video_url (direct media) OR source_url (a YouTube/Vimeo/TikTok link). Optional per-job choices: output format, caption style and formatting (italic, underline, strikethrough, uppercase, Light to Bold), clip length, genre, a focus prompt, a timeframe, b-roll and branding; anything left out follows your brand template. Every option is checked before the job is charged: an unknown value is a 422 naming the field. Returns 202 Accepted with a job_uid; poll GET /v1/shorts/{uid}, or pass webhook_url to be told when it is done (job.completed / job.failed, also sent to your registered webhooks). Billed per REQUESTED clip from your API wallet; a wholly-failed job is refunded automatically. Requires scope videos:write.

POST

shorts

generate

curl --request POST \
  --url https://api.smartlyq.com/v1/shorts/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "clip_count": 5,
  "language": "en",
  "caption_style": "word-pop",
  "caption_format": {
    "uppercase": true,
    "light_bold": true
  },
  "clip_length": "60",
  "focus": "the funniest moments",
  "timeframe": {
    "start_s": 30,
    "end_s": 900
  },
  "webhook_url": "https://example.com/hooks/smartlyq"
}
'

import requests

url = "https://api.smartlyq.com/v1/shorts/generate"

payload = {
    "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "clip_count": 5,
    "language": "en",
    "caption_style": "word-pop",
    "caption_format": {
        "uppercase": True,
        "light_bold": True
    },
    "clip_length": "60",
    "focus": "the funniest moments",
    "timeframe": {
        "start_s": 30,
        "end_s": 900
    },
    "webhook_url": "https://example.com/hooks/smartlyq"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    source_url: 'https://www.youtube.com/watch?v=VIDEO_ID',
    clip_count: 5,
    language: 'en',
    caption_style: 'word-pop',
    caption_format: {uppercase: true, light_bold: true},
    clip_length: '60',
    focus: 'the funniest moments',
    timeframe: {start_s: 30, end_s: 900},
    webhook_url: 'https://example.com/hooks/smartlyq'
  })
};

fetch('https://api.smartlyq.com/v1/shorts/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.smartlyq.com/v1/shorts/generate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'source_url' => 'https://www.youtube.com/watch?v=VIDEO_ID',
    'clip_count' => 5,
    'language' => 'en',
    'caption_style' => 'word-pop',
    'caption_format' => [
        'uppercase' => true,
        'light_bold' => true
    ],
    'clip_length' => '60',
    'focus' => 'the funniest moments',
    'timeframe' => [
        'start_s' => 30,
        'end_s' => 900
    ],
    'webhook_url' => 'https://example.com/hooks/smartlyq'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smartlyq.com/v1/shorts/generate"

	payload := strings.NewReader("{\n  \"source_url\": \"https://www.youtube.com/watch?v=VIDEO_ID\",\n  \"clip_count\": 5,\n  \"language\": \"en\",\n  \"caption_style\": \"word-pop\",\n  \"caption_format\": {\n    \"uppercase\": true,\n    \"light_bold\": true\n  },\n  \"clip_length\": \"60\",\n  \"focus\": \"the funniest moments\",\n  \"timeframe\": {\n    \"start_s\": 30,\n    \"end_s\": 900\n  },\n  \"webhook_url\": \"https://example.com/hooks/smartlyq\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.smartlyq.com/v1/shorts/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source_url\": \"https://www.youtube.com/watch?v=VIDEO_ID\",\n  \"clip_count\": 5,\n  \"language\": \"en\",\n  \"caption_style\": \"word-pop\",\n  \"caption_format\": {\n    \"uppercase\": true,\n    \"light_bold\": true\n  },\n  \"clip_length\": \"60\",\n  \"focus\": \"the funniest moments\",\n  \"timeframe\": {\n    \"start_s\": 30,\n    \"end_s\": 900\n  },\n  \"webhook_url\": \"https://example.com/hooks/smartlyq\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smartlyq.com/v1/shorts/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source_url\": \"https://www.youtube.com/watch?v=VIDEO_ID\",\n  \"clip_count\": 5,\n  \"language\": \"en\",\n  \"caption_style\": \"word-pop\",\n  \"caption_format\": {\n    \"uppercase\": true,\n    \"light_bold\": true\n  },\n  \"clip_length\": \"60\",\n  \"focus\": \"the funniest moments\",\n  \"timeframe\": {\n    \"start_s\": 30,\n    \"end_s\": 900\n  },\n  \"webhook_url\": \"https://example.com/hooks/smartlyq\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "job_uid": "shorts_8f21c04a",
    "status": "queued",
    "clip_count": 3,
    "options": {
      "caption_style": "word-pop",
      "caption_format": {
        "uppercase": true,
        "light_bold": true
      },
      "clip_length": "60"
    },
    "language": "en",
    "webhook_url": "https://example.com/hooks/smartlyq",
    "webhook_secret": "whsec_********"
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or malformed Authorization header",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet balance is insufficient for this request",
    "details": {
      "required": "0.0250",
      "balance": "0.0100"
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "API key lacks required scope: social:write",
    "details": {
      "required_scope": "social:write"
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: content, platforms.",
    "details": {
      "fields": [
        "content",
        "platforms"
      ]
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

Authorizations

Authorization

string

header

required

API key from Developer dashboard (Bearer token).

Body

application/json

video_url

string

Direct media URL (provide this or source_url).

source_url

string

Platform link (YouTube/Vimeo/TikTok/Loom/...), downloaded server-side.

clip_count

integer

default:10

Clips to produce (3-20). Billed per requested clip.

language

string

default:auto

Spoken language: a code from GET /v1/languages, or "auto" to detect it. An unknown code is a 422.

Example:

"en"

caption_style

string

Caption style id for this job (default: your brand template's style). List them with GET /v1/shorts/caption-styles.

Example:

"word-pop"

caption_format

object

Text formatting on top of the caption style, for this job only. Each switch is optional; leave one out to keep the style's own look.

Show child attributes

clip_length

enum<string>

default:auto

Target clip length: auto (20-90 s), 30 (12-30 s), 60 (30-60 s) or 90 (60-90 s). Clips always start and end on whole sentences.

Available options:

auto,

30,

60,

90

genre

enum<string>

What kind of video it is, so the AI knows what makes a good moment. Left out = detected.

Available options:

podcast,

lifestyle,

sports,

marketing,

entertainment,

news,

education

focus

string

What to look for, in plain words, e.g. 'the moments about pricing' or 'only when the guest is speaking'.

Maximum string length: 300

Example:

"the funniest moments"

timeframe

object

Only pick clips from this part of the video. Leave end_s out for 'to the end'. Must be at least as long as the shortest clip for clip_length.

Show child attributes

magic_broll

boolean

Stock b-roll cutaways (clips of 6 s or longer, not in split screen): true = on, false = off even if the brand template has it on, omit = brand template.

apply_brand_template

boolean

default:true

false = clean clips with no captions, hook, logo or music (caption_style and caption_format cannot be used then).

format

enum<string>

default:9:16

Output format (aspect ratio) of every clip: 9:16 vertical (TikTok, Reels, Shorts), 4:5 portrait (Instagram feed), 1:1 square or 16:9 landscape (YouTube, LinkedIn). The speaker is followed and the captions, hook, logo and CTA are placed for that canvas. GET /v1/shorts/caption-styles lists them with their pixel size.

Available options:

9:16,

4:5,

1:1,

16:9

webhook_url

string<uri>

Public HTTPS URL to POST job.completed or job.failed to when this job finishes (same envelope, signature and retries as registered webhooks). It is signed with this job's own webhook_secret, returned once in the 202.

Maximum string length: 2048

Example:

"https://example.com/hooks/smartlyq"

Response

Accepted — poll GET /v1/shorts/{uid} for the ranked clips

success

enum<boolean>

Available options:

true

data

object

Show child attributes

meta

object

Show child attributes

Generate viral shorts from a long video

curl --request POST \
  --url https://api.smartlyq.com/v1/shorts/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "clip_count": 5,
  "language": "en",
  "caption_style": "word-pop",
  "caption_format": {
    "uppercase": true,
    "light_bold": true
  },
  "clip_length": "60",
  "focus": "the funniest moments",
  "timeframe": {
    "start_s": 30,
    "end_s": 900
  },
  "webhook_url": "https://example.com/hooks/smartlyq"
}
'

import requests

url = "https://api.smartlyq.com/v1/shorts/generate"

payload = {
    "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "clip_count": 5,
    "language": "en",
    "caption_style": "word-pop",
    "caption_format": {
        "uppercase": True,
        "light_bold": True
    },
    "clip_length": "60",
    "focus": "the funniest moments",
    "timeframe": {
        "start_s": 30,
        "end_s": 900
    },
    "webhook_url": "https://example.com/hooks/smartlyq"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    source_url: 'https://www.youtube.com/watch?v=VIDEO_ID',
    clip_count: 5,
    language: 'en',
    caption_style: 'word-pop',
    caption_format: {uppercase: true, light_bold: true},
    clip_length: '60',
    focus: 'the funniest moments',
    timeframe: {start_s: 30, end_s: 900},
    webhook_url: 'https://example.com/hooks/smartlyq'
  })
};

fetch('https://api.smartlyq.com/v1/shorts/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.smartlyq.com/v1/shorts/generate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'source_url' => 'https://www.youtube.com/watch?v=VIDEO_ID',
    'clip_count' => 5,
    'language' => 'en',
    'caption_style' => 'word-pop',
    'caption_format' => [
        'uppercase' => true,
        'light_bold' => true
    ],
    'clip_length' => '60',
    'focus' => 'the funniest moments',
    'timeframe' => [
        'start_s' => 30,
        'end_s' => 900
    ],
    'webhook_url' => 'https://example.com/hooks/smartlyq'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smartlyq.com/v1/shorts/generate"

	payload := strings.NewReader("{\n  \"source_url\": \"https://www.youtube.com/watch?v=VIDEO_ID\",\n  \"clip_count\": 5,\n  \"language\": \"en\",\n  \"caption_style\": \"word-pop\",\n  \"caption_format\": {\n    \"uppercase\": true,\n    \"light_bold\": true\n  },\n  \"clip_length\": \"60\",\n  \"focus\": \"the funniest moments\",\n  \"timeframe\": {\n    \"start_s\": 30,\n    \"end_s\": 900\n  },\n  \"webhook_url\": \"https://example.com/hooks/smartlyq\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.smartlyq.com/v1/shorts/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source_url\": \"https://www.youtube.com/watch?v=VIDEO_ID\",\n  \"clip_count\": 5,\n  \"language\": \"en\",\n  \"caption_style\": \"word-pop\",\n  \"caption_format\": {\n    \"uppercase\": true,\n    \"light_bold\": true\n  },\n  \"clip_length\": \"60\",\n  \"focus\": \"the funniest moments\",\n  \"timeframe\": {\n    \"start_s\": 30,\n    \"end_s\": 900\n  },\n  \"webhook_url\": \"https://example.com/hooks/smartlyq\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smartlyq.com/v1/shorts/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source_url\": \"https://www.youtube.com/watch?v=VIDEO_ID\",\n  \"clip_count\": 5,\n  \"language\": \"en\",\n  \"caption_style\": \"word-pop\",\n  \"caption_format\": {\n    \"uppercase\": true,\n    \"light_bold\": true\n  },\n  \"clip_length\": \"60\",\n  \"focus\": \"the funniest moments\",\n  \"timeframe\": {\n    \"start_s\": 30,\n    \"end_s\": 900\n  },\n  \"webhook_url\": \"https://example.com/hooks/smartlyq\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "job_uid": "shorts_8f21c04a",
    "status": "queued",
    "clip_count": 3,
    "options": {
      "caption_style": "word-pop",
      "caption_format": {
        "uppercase": true,
        "light_bold": true
      },
      "clip_length": "60"
    },
    "language": "en",
    "webhook_url": "https://example.com/hooks/smartlyq",
    "webhook_secret": "whsec_********"
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or malformed Authorization header",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet balance is insufficient for this request",
    "details": {
      "required": "0.0250",
      "balance": "0.0100"
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "API key lacks required scope: social:write",
    "details": {
      "required_scope": "social:write"
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: content, platforms.",
    "details": {
      "fields": [
        "content",
        "platforms"
      ]
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

Core

CRM

Profiles

AI Generation

Social

Ads

WhatsApp

Inbox

AI Assistants

Generate viral shorts from a long video

Authorizations

Body

Response