curl --request POST \
--url https://api.viddyscribe.com/enterprise/api/generate_ad_text_from_file \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <api-key>' \
--form file='@example-file' \
--form 'filename=<string>' \
--form format=json \
--form language=en-US \
--form video_category=Auto \
--form ad_type=extended_ad \
--form 'custom_instructions=<string>'{
"job_id": "task_abc123xyz",
"status": "queued",
"media_id": "550e8400-e29b-41d4-a716-446655440000"
}Upload a video file and immediately generate audio description text in one request. Returns a job_id for tracking progress.
curl --request POST \
--url https://api.viddyscribe.com/enterprise/api/generate_ad_text_from_file \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <api-key>' \
--form file='@example-file' \
--form 'filename=<string>' \
--form format=json \
--form language=en-US \
--form video_category=Auto \
--form ad_type=extended_ad \
--form 'custom_instructions=<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
json, vtt, edl 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