curl --request POST \
--url https://api.viddyscribe.com/enterprise/api/generate_ad_video_from_file \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <api-key>' \
--form file='@example-file' \
--form 'filename=<string>' \
--form format=vtt \
--form language=en-US \
--form video_category=Auto \
--form ad_type=extended_ad \
--form 'custom_instructions=<string>' \
--form resolution=Auto \
--form 'volume_option=<string>' \
--form volume_level_db=123 \
--form 'edl_content=<string>'{
"job_id": "task_abc123xyz",
"status": "queued",
"media_id": "550e8400-e29b-41d4-a716-446655440000"
}Upload a video file and immediately generate video with audio descriptions in one request. Returns a job_id for tracking progress.
curl --request POST \
--url https://api.viddyscribe.com/enterprise/api/generate_ad_video_from_file \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <api-key>' \
--form file='@example-file' \
--form 'filename=<string>' \
--form format=vtt \
--form language=en-US \
--form video_category=Auto \
--form ad_type=extended_ad \
--form 'custom_instructions=<string>' \
--form resolution=Auto \
--form 'volume_option=<string>' \
--form volume_level_db=123 \
--form 'edl_content=<string>'{
"job_id": "task_abc123xyz",
"status": "queued",
"media_id": "550e8400-e29b-41d4-a716-446655440000"
}API key for authentication. Obtain from your team admin.
Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz
Video file to upload
Optional custom filename
Output format for descriptions
vtt, edl, json Target language (BCP-47 format)
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 Video category for optimized descriptions
Auto, Educational Lecture, Documentary, Narrative Story, Social Media, Tutorial/How-To, Vlog, Commercial/Advertisement, News, Entertainment, Home Video, Video Call Audio description type
extended_ad, standard_ad Optional custom instructions for AI
Output video resolution (Auto for automatic selection)
Volume adjustment method (e.g., normalize, compress)
Specific volume level adjustment in decibels
Custom EDL content for Pro+ users (skips automatic description generation)