Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Publicly reachable audio/video URL for Speechmatics to fetch and transcribe."
},
"domain": {
"type": "string",
"description": "Domain-specific model hint, e.g. finance."
},
"language": {
"type": "string",
"default": "en",
"description": "Transcription language code, e.g. en, es, de, fr."
},
"summarize": {
"type": "boolean",
"description": "If true, also produce a summary of the transcript."
},
"diarization": {
"enum": [
"none",
"speaker",
"channel"
],
"type": "string",
"description": "Speaker labeling: speaker (who spoke) | channel (per audio channel) | none."
},
"summary_type": {
"enum": [
"paragraphs",
"bullets"
],
"type": "string",
"description": "Summary layout (when summarize=true)."
},
"output_locale": {
"type": "string",
"description": "Output spelling locale, e.g. en-US, en-GB."
},
"summary_length": {
"enum": [
"brief",
"detailed"
],
"type": "string",
"description": "Summary length (when summarize=true)."
},
"enable_entities": {
"type": "boolean",
"description": "Emit formatted entities (numbers, dates) in results."
},
"operating_point": {
"enum": [
"standard",
"enhanced",
"melia-1"
],
"type": "string",
"description": "Accuracy/speed tradeoff. enhanced is more accurate; standard is faster/cheaper."
},
"additional_vocab": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
},
"description": "Custom vocabulary — strings, or objects like {\"content\":\"gnocchi\",\"sounds_like\":[\"nyohki\"]}."
},
"notification_url": {
"type": "string",
"description": "Webhook URL to POST the transcript to when the job completes."
},
"fetch_auth_headers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Auth headers to send when fetching a private URL, e.g. [\"Authorization: Bearer xyz\"]."
},
"summary_content_type": {
"enum": [
"auto",
"informative",
"conversational"
],
"type": "string",
"description": "Summary content style (when summarize=true)."
},
"translation_target_languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language codes to also translate the transcript into, e.g. [\"es\",\"de\"]."
}
}
}