{"openapi":"3.0.0","info":{"description":"Speech-to-text transcription and audio intelligence platform","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"Speech-to-text transcription and audio intelligence platform","url":"https://api.apirails.com/deepgram"}],"paths":{"/v1/projects/{project_id}/balances":{"get":{"tags":["Billing"],"parameters":[{"name":"project_id","in":"path","description":"Generates a list of outstanding balances for the specified project. To see balances the authenticated account must be a project owner or administrator.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-all-balances","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/balances"},"summary":"Get All Balances","description":"Get All Balances","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/balances/{balance_id}":{"get":{"tags":["Billing"],"parameters":[{"name":"balance_id","in":"path","description":"Unique identifier of the balance that you want to retrieve.","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve the specified balance","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-balance","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/balances/{balance_id}"},"summary":"Get Balance","description":"Get Balance","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/invites":{"get":{"tags":["Invitations"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to list invites.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/list-invites","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/invites"},"summary":"List Invites","description":"List Invites","security":[{"bearerAuth":[]}]},"post":{"tags":["Invitations"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to send an invite for.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/send-invites","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/invites"},"summary":"Send Invite","description":"Send Invite","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to invite to the project","required":true},"scope":{"type":"string","description":"Scope to give the user","required":true}}},"example":{"email":"","scope":""}}}}}},"/v1/projects/{project_id}/invites/{email}":{"delete":{"tags":["Invitations"],"parameters":[{"name":"email","in":"path","description":"Email of the invite you want to delete","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Unique identifier of the project from which you want to remove the authenticated account","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/delete-invite","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/invites/{email}"},"summary":"Delete Invite","description":"Delete Invite","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/projects/{project_id}/leave":{"delete":{"tags":["Invitations"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project from which you want to remove the authenticated account.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/leave-project","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/leave"},"summary":"Leave Project","description":"Leave Project","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/projects/{project_id}/keys":{"get":{"tags":["Keys"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to get keys","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/list-keys","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/keys"},"summary":"List Keys","description":"List Keys","security":[{"bearerAuth":[]}]},"post":{"tags":["Keys"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to create a key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/create-key","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/keys"},"summary":"Create Key","description":"Create Key","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"comment":{"type":"string","description":"Comments associated with the key you would like to create. Must be between 1 and 128 characters long not including whitespace","required":true},"scopes":{"type":"array","description":"Scopes for the key you would like to create.","required":true,"items":{"type":"string"}}}},"example":{"comment":"","scopes":[]}}}}}},"/v1/projects/{project_id}/keys/{key_id}":{"get":{"tags":["Keys"],"parameters":[{"name":"key_id","in":"path","description":"Unique identifier of the key that you want to retrieve.","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to get keys","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-key","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/keys/{key_id}"},"summary":"Get Key","description":"Get Key","security":[{"bearerAuth":[]}]},"delete":{"tags":["Keys"],"parameters":[{"name":"key_id","in":"path","description":"Unique identifier of the key that you want to delete.","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Unique identifier of the project that contains the key that you want to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/delete-key","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/keys/{key_id}"},"summary":"Delete Key","description":"Delete Key","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/projects/{project_id}/members":{"get":{"tags":["Members"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to get members.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-members","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/members"},"summary":"Get Members","description":"Get Members","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/members/{member_id}":{"delete":{"tags":["Members"],"parameters":[{"name":"member_id","in":"path","description":"Unique identifier of the account that you want to remove.","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to get members","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/remove-member","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/members/{member_id}"},"summary":"Remove Member","description":"Remove Member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/projects":{"get":{"tags":["Projects"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-projects","api_endpoint":"https://api.deepgram.com/v1/projects"},"summary":"Get Projects","description":"Get Projects","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}":{"get":{"tags":["Projects"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve information.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-project","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}"},"summary":"Get Project","description":"Get Project","security":[{"bearerAuth":[]}]},"patch":{"tags":["Projects"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project that you want to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/update-project","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}"},"summary":"Update Project","description":"Update Project","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"delete":{"tags":["Projects"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project that you want to delete.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/delete-project","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}"},"summary":"Delete Project","description":"Delete Project","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/projects/{project_id}/members/{member_id}/scopes":{"get":{"tags":["Scopes"],"parameters":[{"name":"member_id","in":"path","description":"Unique identifier of the member for whom you want to get scopes.","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Identifier of the project that contains the member for whom you want to get scopes","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-member-scopes","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/members/{member_id}/scopes"},"summary":"Get Member Scopes","description":"Get Member Scopes","security":[{"bearerAuth":[]}]},"put":{"tags":["Scopes"],"parameters":[{"name":"member_id","in":"path","description":"Unique identifier of the member for whom you want to update the scope.","required":true,"schema":{"type":"string","example":""}},{"name":"project_id","in":"path","description":"Unique identifier of the project that contains the specified member and scope that you want to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/update-scope","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/members/{member_id}/scopes"},"summary":"Update Scope","description":"Update Scope","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"scope":{"type":"string","description":"Scope for the specified member and project."}}},"example":{"scope":""}}}}}},"/v1/projects/{project_id}/requests":{"get":{"tags":["Usage"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve requests..","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"End date of the requested date range","schema":{"type":"","example":""}},{"name":"limit","in":"query","description":"Number of results to return per page","schema":{"type":"number","example":""}},{"name":"start","in":"query","description":"Start date of the requested date range","schema":{"type":"","example":""}},{"name":"status","in":"query","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-all-requests","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/requests"},"summary":"Get All Requests","description":"Get All Requests","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/requests/{request_id}":{"get":{"tags":["Usage"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve the specified request","required":true,"schema":{"type":"string","example":""}},{"name":"request_id","in":"path","description":"Unique identifier of the request that you want to retrieve.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-request","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/requests/{request_id}"},"summary":"Get Request","description":"Get Request","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/usage":{"get":{"tags":["Usage"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve the specified request.","required":true,"schema":{"type":"string","example":""}},{"name":"method","in":"query","description":"Limits results to requests processed using the specified method","schema":{"type":"string","example":""}},{"name":"accessor","in":"query","description":"Limits results to the given API key","schema":{"type":"string","example":""}},{"name":"alternatives","in":"query","description":"Limits results to requests that include the alternatives feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"detect_topics","in":"query","description":"Limits results to requests that include the detect_topics feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"diarize","in":"query","description":"Limits results to requests that include the diarize feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"end","in":"query","description":"End date of the requested date range","schema":{"type":"","example":""}},{"name":"interim_results","in":"query","description":"Limits results to requests that include the interim_results feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"keywords","in":"query","description":"Limits results to requests that include the keywords feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"model","in":"query","description":"Limits results to requests run with the specified model UUID applied","schema":{"type":"string","example":""}},{"name":"multichannel","in":"query","description":"Limits results to requests that include the multichannel feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"ner","in":"query","description":"Limits results to requests that include the ner feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"numerals","in":"query","description":"Limits results to requests that include the numerals feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"profanity_filter","in":"query","description":"Limits results to requests that include the profanity_filter feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"punctuate","in":"query","description":"Limits results to requests that include the punctuate feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"redact","in":"query","description":"Limits results to requests that include the redact feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"replace","in":"query","description":"Limits results to requests that include the replace feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"search","in":"query","description":"Limits results to requests that include the search feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"smart_format","in":"query","description":"Limits results to requests that include the smart_format feature.","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"start","in":"query","description":"Start date of the requested date range","schema":{"type":"","example":""}},{"name":"tag","in":"query","description":"Limits results to requests associated with the specified tag","schema":{"type":"string","example":""}},{"name":"utterances","in":"query","description":"Limits results to requests that include the utterances feature","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/summarize-usage","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/usage"},"summary":"Summarize Usage","description":"Summarize Usage","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/usage/fields":{"get":{"tags":["Usage"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve fields.","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"End date of the requested date range. Format is YYYY-MM-DD. If a full timestamp is given it will be truncated to a day. Dates are UTC. Defaults to the current date.","schema":{"type":"string","example":""}},{"name":"start","in":"query","description":"Start date of the requested date range. Format is YYYY-MM-DD. If a full timestamp is given it will be truncated to a day. Dates are UTC. Defaults to the date of your first request","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-fields","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/usage/fields"},"summary":"Get Fields","description":"Get Fields","security":[{"bearerAuth":[]}]}},"/v1/listen":{"post":{"tags":["Transcription"],"parameters":[{"name":"detect_language","in":"query","description":"Enable automatic language detection","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"diarize","in":"query","description":"Enable speaker diarization","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"keywords","in":"query","description":"List of keywords to boost in the transcription","schema":{"type":"array","example":""}},{"name":"language","in":"query","description":"Language of the input audio in ISO-639-1 format. If not provided, Deepgram will attempt to detect the language automatically","schema":{"type":"string","example":""}},{"name":"model","in":"query","description":"Model to use for transcription. Options include: nova-2, nova, whisper-large, enhanced, base","schema":{"type":"string","example":""}},{"name":"multichannel","in":"query","description":"Enable multichannel transcription","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"numerals","in":"query","description":"Convert numbers to written format","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"paragraphs","in":"query","description":"Enable paragraph detection","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"profanity_filter","in":"query","description":"Enable profanity filtering","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"punctuate","in":"query","description":"Enable automatic punctuation","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"redact","in":"query","description":"Enable redaction of sensitive information","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"replace","in":"query","description":"List of terms to replace in the transcription","schema":{"type":"array","example":""}},{"name":"search","in":"query","description":"List of terms to search for in the transcription","schema":{"type":"array","example":""}},{"name":"tier","in":"query","description":"Tier to use for transcription. Options include: nova, base, enhanced","schema":{"type":"string","example":""}},{"name":"utt_split","in":"query","description":"Utterance split threshold in seconds","schema":{"type":"number","example":""}},{"name":"utterances","in":"query","description":"Enable utterance detection","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"version","in":"query","description":"Version of the model to use","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/pre-recorded-transcription","api_endpoint":"https://api.deepgram.com/v1/listen"},"summary":"Transcribe Pre-recorded Audio File","description":"Transcribe pre-recorded audio files by uploading a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"Audio file to transcribe. Supported formats: mp3, mp4, wav, flac, ogg, webm, m4a, opus, 3gp","required":true}}},"example":{"file":"(binary)"}}}}}},"/v1/projects/{project_id}/listen/requests":{"get":{"tags":["Transcription"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project for which you want to retrieve transcription requests","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"End date of the requested date range. Format is YYYY-MM-DD","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of results to return per page","schema":{"type":"number","example":""}},{"name":"start","in":"query","description":"Start date of the requested date range. Format is YYYY-MM-DD","schema":{"type":"string","example":""}},{"name":"status","in":"query","description":"Filter by request status","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/list-transcription-requests","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/listen/requests"},"summary":"List Transcription Requests","description":"List all transcription requests for a project","security":[{"bearerAuth":[]}]}},"/v1/projects/{project_id}/listen/requests/{request_id}":{"get":{"tags":["Transcription"],"parameters":[{"name":"project_id","in":"path","description":"Unique identifier of the project","required":true,"schema":{"type":"string","example":""}},{"name":"request_id","in":"path","description":"Unique identifier of the transcription request","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/get-transcription-request","api_endpoint":"https://api.deepgram.com/v1/projects/{project_id}/listen/requests/{request_id}"},"summary":"Get Transcription Request","description":"Get details of a specific transcription request","security":[{"bearerAuth":[]}]}},"/v1/speak":{"post":{"tags":["Speech"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.deepgram.com/reference/text-to-speech","api_endpoint":"https://api.deepgram.com/v1/speak"},"summary":"Text to Speech","description":"Convert text to natural-sounding speech","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Text to convert to speech","required":true},"container":{"type":"string","description":"Container format. Options include: mp3, wav, ogg, flac"},"encoding":{"type":"string","description":"Audio encoding format. Options include: linear16, mulaw, alaw, pcm_s16le, pcm_s24le, pcm_s32le, pcm_f32le, pcm_mulaw, pcm_alaw"},"model":{"type":"string","description":"Model to use for text-to-speech. Options include: aura-2-asteria-en, aura-2-luna-en, aura-2-stella-en, aura-athena-en, aura-hera-en, aura-orion-en, aura-arcas-en, aura-perseus-en, aura-zeus-en, nova-2, etc."},"sample_rate":{"type":"number","description":"Sample rate in Hz. Options include: 8000, 11025, 16000, 22050, 24000, 32000, 44100, 48000"}}},"example":{"text":"","container":"","encoding":"","model":"","sample_rate":""}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}