GET
/v1/schemas/deepgram/audio/v1%2Flisten?kind=output
Accept:
Response body
0 properties · 0 required · 0 $defsThis schema isn’t a plain object with properties — showing the raw JSON instead.
application/json
{
"provider": "deepgram",
"activity": "audio",
"endpointId": "v1/listen",
"kind": "output",
"contentHash": "3ba46541226a1dcabe5fbf37e21d0ac459029ae43c79e9fb8c8b16ff551f0101",
"specRevision": null,
"provenance": {
"sourceUrl": "https://developers.deepgram.com/openapi.json",
"sourceHash": "f91de57c05631ad01baabd75ab7cb2938a1ef69e11b1449e05e3bf256838db99",
"fetchedAt": 1792819826,
"extractorVersion": "1",
"derivation": "upstream-spec",
"verifiedAt": null
},
"createdAt": 1792819826,
"supersededAt": null,
"schema": {
"oneOf": [
{
"$ref": "#/$defs/ListenV1Response"
},
{
"$ref": "#/$defs/ListenV1AcceptedResponse"
}
],
"title": "listen_v1_media_transcribe_Response_200",
"$defs": {
"ListenV1AcceptedResponse": {
"type": "object",
"properties": {
"request_id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for tracking the asynchronous request"
}
},
"required": [
"request_id"
],
"description": "Accepted response for asynchronous transcription requests",
"title": "ListenV1AcceptedResponse"
},
"ListenV1Response": {
"type": "object",
"properties": {
"metadata": {
"$ref": "#/$defs/ListenV1ResponseMetadata"
},
"results": {
"$ref": "#/$defs/ListenV1ResponseResults"
}
},
"required": [
"metadata",
"results"
],
"description": "The standard transcription response",
"title": "ListenV1Response"
},
"ListenV1ResponseMetadata": {
"type": "object",
"properties": {
"transaction_key": {
"type": "string",
"default": "deprecated",
"deprecated": true
},
"request_id": {
"type": "string",
"format": "uuid"
},
"sha256": {
"type": "string"
},
"created": {
"type": "string",
"format": "date-time"
},
"duration": {
"type": "number",
"format": "double"
},
"channels": {
"type": "integer"
},
"models": {
"type": "array",
"items": {
"type": "string"
}
},
"model_info": {
"$ref": "#/$defs/ListenV1ResponseMetadataModelInfo"
},
"diarize_info": {
"$ref": "#/$defs/ListenV1ResponseMetadataDiarizeInfo",
"description": "The diarizer that produced the speaker labels. Present only when a diarizer ran."
},
"summary_info": {
"$ref": "#/$defs/ListenV1ResponseMetadataSummaryInfo"
},
"sentiment_info": {
"$ref": "#/$defs/ListenV1ResponseMetadataSentimentInfo"
},
"topics_info": {
"$ref": "#/$defs/ListenV1ResponseMetadataTopicsInfo"
},
"intents_info": {
"$ref": "#/$defs/ListenV1ResponseMetadataIntentsInfo"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"request_id",
"sha256",
"created",
"duration",
"channels",
"models",
"model_info"
],
"title": "ListenV1ResponseMetadata"
},
"ListenV1ResponseMetadataDiarizeInfo": {
"type": "object",
"properties": {
"model_uuid": {
"type": "string",
"description": "The diarizer model UUID"
},
"arch": {
"type": "string",
"description": "The diarizer arch, such as `v1` or `v2`"
}
},
"required": [
"model_uuid",
"arch"
],
"description": "The diarizer that produced the speaker labels. Present only when a diarizer ran.",
"title": "ListenV1ResponseMetadataDiarizeInfo"
},
"ListenV1ResponseMetadataIntentsInfo": {
"type": "object",
"properties": {
"model_uuid": {
"type": "string"
},
"input_tokens": {
"type": "integer"
},
"output_tokens": {
"type": "integer"
}
},
"title": "ListenV1ResponseMetadataIntentsInfo"
},
"ListenV1ResponseMetadataModelInfo": {
"type": "object",
"properties": {},
"title": "ListenV1ResponseMetadataModelInfo"
},
"ListenV1ResponseMetadataSentimentInfo": {
"type": "object",
"properties": {
"model_uuid": {
"type": "string"
},
"input_tokens": {
"type": "integer"
},
"output_tokens": {
"type": "integer"
}
},
"title": "ListenV1ResponseMetadataSentimentInfo"
},
"ListenV1ResponseMetadataSummaryInfo": {
"type": "object",
"properties": {
"model_uuid": {
"type": "string"
},
"input_tokens": {
"type": "integer"
},
"output_tokens": {
"type": "integer"
}
},
"title": "ListenV1ResponseMetadataSummaryInfo"
},
"ListenV1ResponseMetadataTopicsInfo": {
"type": "object",
"properties": {
"model_uuid": {
"type": "string"
},
"input_tokens": {
"type": "integer"
},
"output_tokens": {
"type": "integer"
}
},
"title": "ListenV1ResponseMetadataTopicsInfo"
},
"ListenV1ResponseResults": {
"type": "object",
"properties": {
"channels": {
"$ref": "#/$defs/ListenV1ResponseResultsChannels"
},
"utterances": {
"$ref": "#/$defs/ListenV1ResponseResultsUtterances"
},
"summary": {
"$ref": "#/$defs/ListenV1ResponseResultsSummary"
},
"topics": {
"$ref": "#/$defs/SharedTopics"
},
"intents": {
"$ref": "#/$defs/SharedIntents"
},
"sentiments": {
"$ref": "#/$defs/SharedSentiments"
}
},
"required": [
"channels"
],
"title": "ListenV1ResponseResults"
},
"ListenV1ResponseResultsChannels": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItems"
},
"title": "ListenV1ResponseResultsChannels"
},
"ListenV1ResponseResultsChannelsItems": {
"type": "object",
"properties": {
"search": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsSearchItems"
}
},
"alternatives": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItems"
}
},
"detected_language": {
"type": "string"
}
},
"title": "ListenV1ResponseResultsChannelsItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItems": {
"type": "object",
"properties": {
"transcript": {
"type": "string"
},
"confidence": {
"type": "string",
"title": "float"
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tags of the languages detected in the transcript, sorted by word count in descending order. Only present when `language=multi`. Can be absent on audio that switches languages."
},
"languages_hinted": {
"type": "array",
"items": {
"type": "string"
},
"description": "The `language_hint` values for the request, normalized: codes are returned in canonical form (`ES` → `es`, `zh-hk` → `zh-HK`), and a regional code the model has no tag for is returned as its base language (`en-GB` → `en`). Returned on every Nova-3 multilingual response (`model=nova-3&language=multi`); an empty array when no `language_hint` was sent."
},
"words": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsWordsItems"
}
},
"paragraphs": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphs"
},
"entities": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsEntitiesItems"
}
},
"summaries": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsSummariesItems"
}
},
"topics": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsTopicsItems"
}
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsEntitiesItems": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "string"
},
"raw_value": {
"type": "string"
},
"confidence": {
"type": "string",
"title": "float"
},
"start_word": {
"type": "string",
"title": "float"
},
"end_word": {
"type": "string",
"title": "float"
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsEntitiesItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphs": {
"type": "object",
"properties": {
"transcript": {
"type": "string"
},
"paragraphs": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItems"
}
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphs"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItems": {
"type": "object",
"properties": {
"sentences": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItemsSentencesItems"
}
},
"speaker": {
"type": "integer"
},
"num_words": {
"type": "integer"
},
"start": {
"type": "string",
"title": "float"
},
"end": {
"type": "string",
"title": "float"
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItemsSentencesItems": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"start": {
"type": "string",
"title": "float"
},
"end": {
"type": "string",
"title": "float"
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItemsSentencesItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsSummariesItems": {
"type": "object",
"properties": {
"summary": {
"type": "string"
},
"start_word": {
"type": "string",
"title": "float"
},
"end_word": {
"type": "string",
"title": "float"
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsSummariesItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsTopicsItems": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"start_word": {
"type": "string",
"title": "float"
},
"end_word": {
"type": "string",
"title": "float"
},
"topics": {
"type": "array",
"items": {
"type": "string"
}
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsTopicsItems"
},
"ListenV1ResponseResultsChannelsItemsAlternativesItemsWordsItems": {
"type": "object",
"properties": {
"word": {
"type": "string"
},
"start": {
"type": "string",
"title": "float"
},
"end": {
"type": "string",
"title": "float"
},
"confidence": {
"type": "string",
"title": "float"
},
"language": {
"type": "string",
"description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tag of the word's detected language. Only present when `language=multi`. Can be absent on audio that switches languages."
},
"speaker": {
"type": "integer",
"description": "The speaker of the word, present when diarization is enabled"
},
"speaker_confidence": {
"type": "string",
"title": "float",
"description": "Confidence in the speaker assignment. Returned only for pre-recorded diarization; not available for streaming"
}
},
"title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsWordsItems"
},
"ListenV1ResponseResultsChannelsItemsSearchItems": {
"type": "object",
"properties": {
"query": {
"type": "string"
},
"hits": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsSearchItemsHitsItems"
}
}
},
"title": "ListenV1ResponseResultsChannelsItemsSearchItems"
},
"ListenV1ResponseResultsChannelsItemsSearchItemsHitsItems": {
"type": "object",
"properties": {
"confidence": {
"type": "string",
"title": "float"
},
"start": {
"type": "string",
"title": "float"
},
"end": {
"type": "string",
"title": "float"
},
"snippet": {
"type": "string"
}
},
"title": "ListenV1ResponseResultsChannelsItemsSearchItemsHitsItems"
},
"ListenV1ResponseResultsSummary": {
"type": "object",
"properties": {
"result": {
"type": "string"
},
"short": {
"type": "string"
}
},
"title": "ListenV1ResponseResultsSummary"
},
"ListenV1ResponseResultsUtterances": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsUtterancesItems"
},
"title": "ListenV1ResponseResultsUtterances"
},
"ListenV1ResponseResultsUtterancesItems": {
"type": "object",
"properties": {
"start": {
"type": "string",
"title": "float"
},
"end": {
"type": "string",
"title": "float"
},
"confidence": {
"type": "string",
"title": "float"
},
"channel": {
"type": "integer"
},
"transcript": {
"type": "string"
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tags of the languages detected in the utterance, sorted by word count in descending order. Only present when `language=multi`."
},
"words": {
"type": "array",
"items": {
"$ref": "#/$defs/ListenV1ResponseResultsUtterancesItemsWordsItems"
}
},
"speaker": {
"type": "integer"
},
"id": {
"type": "string",
"format": "uuid"
}
},
"title": "ListenV1ResponseResultsUtterancesItems"
},
"ListenV1ResponseResultsUtterancesItemsWordsItems": {
"type": "object",
"properties": {
"word": {
"type": "string"
},
"start": {
"type": "string",
"title": "float"
},
"end": {
"type": "string",
"title": "float"
},
"confidence": {
"type": "string",
"title": "float"
},
"language": {
"type": "string",
"description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tag of the word's detected language. Only present when `language=multi`. Can be absent on audio that switches languages."
},
"speaker": {
"type": "integer"
},
"speaker_confidence": {
"type": "string",
"title": "float"
},
"punctuated_word": {
"type": "string"
}
},
"title": "ListenV1ResponseResultsUtterancesItemsWordsItems"
},
"SharedIntents": {
"type": "object",
"properties": {
"segments": {
"type": "array",
"items": {
"$ref": "#/$defs/SharedIntentsSegmentsItems"
}
}
},
"description": "Output whenever `intents=true` is used",
"title": "SharedIntents"
},
"SharedIntentsSegmentsItems": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"start_word": {
"type": "number",
"format": "double"
},
"end_word": {
"type": "number",
"format": "double"
},
"intents": {
"type": "array",
"items": {
"$ref": "#/$defs/SharedIntentsSegmentsItemsIntentsItems"
}
}
},
"title": "SharedIntentsSegmentsItems"
},
"SharedIntentsSegmentsItemsIntentsItems": {
"type": "object",
"properties": {
"intent": {
"type": "string"
},
"confidence_score": {
"type": "string",
"title": "float"
}
},
"title": "SharedIntentsSegmentsItemsIntentsItems"
},
"SharedSentiments": {
"type": "object",
"properties": {
"segments": {
"type": "array",
"items": {
"$ref": "#/$defs/SharedSentimentsSegmentsItems"
}
},
"average": {
"$ref": "#/$defs/SharedSentimentsAverage"
}
},
"description": "Output whenever `sentiment=true` is used",
"title": "SharedSentiments"
},
"SharedSentimentsAverage": {
"type": "object",
"properties": {
"sentiment": {
"type": "string"
},
"sentiment_score": {
"type": "number",
"format": "double"
}
},
"title": "SharedSentimentsAverage"
},
"SharedSentimentsSegmentsItems": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"start_word": {
"type": "number",
"format": "double"
},
"end_word": {
"type": "number",
"format": "double"
},
"sentiment": {
"type": "string"
},
"sentiment_score": {
"type": "number",
"format": "double"
}
},
"title": "SharedSentimentsSegmentsItems"
},
"SharedTopics": {
"type": "object",
"properties": {
"segments": {
"type": "array",
"items": {
"$ref": "#/$defs/SharedTopicsSegmentsItems"
}
}
},
"description": "Output whenever `topics=true` is used",
"title": "SharedTopics"
},
"SharedTopicsSegmentsItems": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"start_word": {
"type": "number",
"format": "double"
},
"end_word": {
"type": "number",
"format": "double"
},
"topics": {
"type": "array",
"items": {
"$ref": "#/$defs/SharedTopicsSegmentsItemsTopicsItems"
}
}
},
"title": "SharedTopicsSegmentsItems"
},
"SharedTopicsSegmentsItemsTopicsItems": {
"type": "object",
"properties": {
"topic": {
"type": "string"
},
"confidence_score": {
"type": "string",
"title": "float"
}
},
"title": "SharedTopicsSegmentsItemsTopicsItems"
}
}
}
}Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"deepgram","endpointId":"v1/listen","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}