Skip to main content
POST
/
enterprise
/
api
/
generate_ad_video_from_url
Add from URL and generate AD Video
curl --request POST \
  --url https://api.viddyscribe.com/enterprise/api/generate_ad_video_from_url \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source_url": "https://example.com/video.mp4",
  "filename": "<string>",
  "format": "vtt",
  "language": "en-US",
  "video_category": "Auto",
  "ad_type": "extended_ad",
  "custom_instructions": "<string>",
  "resolution": "Auto",
  "volume_option": "<string>",
  "volume_level_db": 123,
  "edl_content": "<string>"
}
'
{
  "job_id": "task_abc123xyz",
  "status": "queued",
  "media_id": "550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Obtain from your team admin.

Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

Body

application/json
​
source_url
string<uri>
required

Publicly accessible video URL

Example:

"https://example.com/video.mp4"

​
filename
string

Optional custom filename

​
format
enum<string>
default:vtt

Output format for descriptions

Available options:
vtt,
edl,
json
​
language
enum<string>
default:en-US

Target language (BCP-47 format)

Available options:
en-US,
en-GB,
en-AU,
en-IN,
es-ES,
es-US,
fr-FR,
fr-CA,
de-DE,
it-IT,
pt-BR,
ja-JP,
ko-KR,
cmn-CN,
ar-XA,
hi-IN,
bn-IN,
da-DK,
fi-FI,
gu-IN,
id-ID,
kn-IN,
ml-IN,
mr-IN,
nb-NO,
nl-NL,
nl-BE,
pl-PL,
ru-RU,
sv-SE,
sw-KE,
ta-IN,
te-IN,
th-TH,
tr-TR,
uk-UA,
ur-IN,
vi-VN
Example:

"en-US"

​
video_category
enum<string>
default:Auto

Video category for optimized descriptions

Available options:
Auto,
Educational Lecture,
Documentary,
Narrative Story,
Social Media,
Tutorial/How-To,
Vlog,
Commercial/Advertisement,
News,
Entertainment,
Home Video,
Video Call
​
ad_type
enum<string>
default:extended_ad

Audio description type

Available options:
extended_ad,
standard_ad
​
custom_instructions
string

Optional custom instructions for AI

​
resolution
string
default:Auto

Output video resolution (Auto for automatic selection)

​
volume_option
string

Volume adjustment method (e.g., normalize, compress)

​
volume_level_db
number

Specific volume level adjustment in decibels

​
edl_content
string

Custom EDL content for Pro+ users (skips automatic description generation)

Response

Job created successfully

​
job_id
string

Unique job identifier for tracking

​
status
enum<string>
Available options:
queued
​
media_id
string<uuid>