Raw schema
{
"type": "object",
"properties": {
"media_url": {
"type": "string",
"maxLength": 4096,
"pattern": "^https?:\\/\\/\\S+$",
"description": "Direct download URL of the audio or video file. Rev.ai fetches it; it must be reachable without login."
},
"language": {
"type": "string",
"pattern": "^[a-z]{2,3}(-[a-z]{2})?(\\/[a-z]{2})?$|^auto$",
"description": "Spoken language as an ISO 639-1 code (en, en-us, en-gb, es, fr, de, ...). Default en."
},
"metadata": {
"description": "A note stored with the job and returned with it (for example your own reference).",
"type": "string",
"maxLength": 512
},
"verbatim": {
"description": "Keep every false start and disfluency (default true for machine jobs).",
"type": "boolean"
},
"skip_diarization": {
"description": "Do not label speakers.",
"type": "boolean"
},
"speakers_count": {
"description": "Number of speakers, if known (English, Spanish, French); improves speaker labels.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"speaker_channels_count": {
"description": "Number of audio channels with one speaker each. Billed per channel.",
"type": "integer",
"minimum": 1,
"maximum": 8
},
"filter_profanity": {
"description": "Mask profanity in the transcript.",
"type": "boolean"
},
"remove_disfluencies": {
"description": "Drop 'ums' and similar fillers.",
"type": "boolean"
},
"skip_punctuation": {
"description": "Return words without punctuation.",
"type": "boolean"
},
"forced_alignment": {
"description": "More accurate per-word timestamps (en, fr, it, de, es).",
"type": "boolean"
},
"summarization_type": {
"description": "Also create a summary, read later with revai_get_summary.",
"type": "string",
"enum": [
"paragraph",
"bullets"
]
},
"delete_after_seconds": {
"description": "Delete the job and its data this many seconds after it completes.",
"type": "integer",
"minimum": 0,
"maximum": 2592000
}
},
"required": [
"media_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}