Skip to main content
POST
/
enterprise
/
api
/
generate_ad_text
curl --request POST \
  --url https://api.viddyscribe.com/enterprise/api/generate_ad_text \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": {
    "type": "media_id",
    "media_id": "550e8400-e29b-41d4-a716-446655440000"
  },
  "generation_config": {
    "language": "en-US",
    "format": "json",
    "ad_type": "extended_ad"
  }
}
'
{
  "job_id": "task_abc123xyz",
  "status": "queued",
  "media_id": "550e8400-e29b-41d4-a716-446655440000"
}

​
Usage Examples

​
1. Using an existing Media ID

If you have already uploaded media and have a media_id, use this method. 
curl -X POST https://api.viddyscribe.com/enterprise/api/generate_ad_text \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "type": "media_id",
      "media_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "generation_config": {
      "language": "en-US",
      "format": "vtt"
    }
  }'

​
2. Using a Public URL

Upload from a URL and generate in a single step. 
curl -X POST https://api.viddyscribe.com/enterprise/api/generate_ad_text \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "type": "url",
      "url": "https://example.com/video.mp4"
    },
    "generation_config": {
      "language": "en-US",
      "format": "json"
    }
  }'

​
3. Uploading a Local File

Upload a file directly and generate in a single step. 
curl -X POST https://api.viddyscribe.com/enterprise/api/generate_ad_text \
  -H "X-API-Key: YOUR_API_KEY" \
  -F 'input={"type": "file"}' \
  -F "file=@/path/to/video.mp4" \
  -F 'generation_config={"language": "en-US", "format": "srt"}'

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Obtain from your team admin.

Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

Body

​
input
Using Media ID · object
required
  • Using Media ID
  • Upload from URL
​
generation_config
object

Configuration for text generation

Response

Job created successfully

​
job_id
string

Unique job identifier for tracking

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

Media being processed