Skip to main content

​
Generate AD Video

Pick one of the two simple flows below to generate audio description video.

​
1. Using a Video from public URL

  1. Upload from a public URL and generate in one step.
curl -X POST https://api.viddyscribe.com/enterprise/api/generate_ad_video_from_url \
  -H "X-API-Key: vsk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://example.com/video.mp4",
    "language": "en-US",
    "ad_type": "extended_ad"
  }'
Response returns a job_id. Use get_results to retrieve the output when ready.

​
2. Using a Video from local file

  1. Upload a local file and generate in one step.
curl -X POST https://api.viddyscribe.com/enterprise/api/generate_ad_video_from_file \
  -H "X-API-Key: vsk_your_api_key_here" \
  -F "[email protected]" \
  -F "language=en-US" \
  -F "ad_type=extended_ad"
The response includes a job_id. Poll get_results for completion. On success, result_url contains the link to the generated video.

​
Tips

  • Prefer short public URLs where possible.
  • Set language to a BCP‑47 tag like en-US.
  • Use ad_type of extended_ad for fuller descriptions or standard_ad for concise ones.

​
Retrieve Results

Use the job_id from the previous step to fetch results: 
curl -X GET "https://api.viddyscribe.com/enterprise/api/get_results?job_id=TASK_ID" \
  -H "X-API-Key: vsk_your_api_key_here"
Example successful response for video jobs: 
{
  "job_id": "task_abc123xyz",
  "status": "done",
  "result_url": "https://storage.googleapis.com/bucket/path/to/result.mp4?X-Goog-Signature=...",
  "created_at": "2025-09-30T08:00:00Z",
  "updated_at": "2025-09-30T08:10:00Z"
}