{"_id":"54513d9aa66f020800dbab53","project":"542dbe0ecb19820800c1f4d7","category":{"_id":"54513cc014af501a00b50d24","__v":4,"pages":["5452381304160008005b1c99","5452455e04160008005b1cd9"],"project":"542dbe0ecb19820800c1f4d7","version":"542ecc0a6b0eb6080066ca77","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-29T19:15:12.521Z","from_sync":false,"order":18,"slug":"transcriptions","title":"Transcriptions"},"is_link":false,"parentDoc":null,"editedParams":true,"__v":0,"editedParams2":true,"version":{"_id":"542ecc0a6b0eb6080066ca77","forked_from":"542dbe0fcb19820800c1f4da","project":"542dbe0ecb19820800c1f4d7","__v":31,"createdAt":"2014-10-03T16:17:14.165Z","releaseDate":"2014-10-03T16:17:14.165Z","categories":["542ecc0a6b0eb6080066ca78","542ef44f6b0eb6080066cb24","543bf3e22a30961a00b66eb3","5446952b82bd7e08002768a0","544821ae8d7af31a00dd41ce","544a7885f1aefa08006efc69","544c758e11845f0e001ed8de","544e5565b80812080035be55","544e558dbd51b9080037f8ca","5450b045a66f020800dba73d","5450eb6aa66f020800dba945","5450f39ea66f020800dba989","5450f877a66f020800dba9cf","54510356a66f020800dbaa17","5451274514af501a00b50c99","54513345a66f020800dbab24","54513cc014af501a00b50d24","54515eec14af501a00b50db9","54519b1d14af501a00b50ea9","54519b2aa66f020800dbacb4","54524f9704160008005b1d27","54538d2308d1800800473d95","54538d420c09721000a06a03","54538e5608d1800800473d9a","5453ea9547c30114004fb375","5453eb12b077c31c00067bcb","5453eb27b077c31c00067bcd","5453ed5db077c31c00067bde","548075cbe291c51a00e7e096","5922fa475c48c70f00f21453","59244fd41e32eb190028ad8d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"user":"542dc547cb19820800c1f4f1","updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-29T19:18:50.677Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":true,"method":"post","results":{"codes":[{"name":"","status":200,"language":"json","code":"{\n\"sid\": \"{TranscriptionSid}\",\n\"date_created\": \"Fri, 27 Jul 2012 15:31:53 +0000\",\n\"date_updated\": \"Fri, 27 Jul 2012 15:32:28 +0000\",\n\"account_sid\": \"{AccountSid}\",\n\"status\": \"completed\",\n\"type\": \"auto\",\n\"audio_url\": \"\",\n\"duration\": \"2\",\n\"transcription_text\": \"\",\n\"api_version\": \"v2\",\n\"price\": \"0.050000\",\n\"transcribe_callback\": \"\",\n\"callback_method\": \"POST\",\n\"uri\": \"/v2/Accounts/{AccountSid}/Transcriptions/{TranscriptionSid}.json\"\n}"},{"code":"{\n    \"status\": 404,\n    \"message\": \"The requested resource was not found: /v2/Accounts/bad/bad_response.json\"\n}","name":"","status":404,"language":"json"}]},"try":true,"auth":"required","params":[{"_id":"54513d9aa66f020800dbab5a","ref":"","in":"path","required":true,"desc":"Account SID.","default":"","type":"string","name":"AccountSid"},{"_id":"54513d9aa66f020800dbab59","ref":"","in":"path","required":true,"desc":"Recording SID.","default":"","type":"string","name":"RecordingSid"},{"_id":"54513d9aa66f020800dbab58","ref":"","in":"body","required":false,"desc":"The URL some parameters regarding the transcription will be passed to once it is completed. The longer the recording time, the longer the process delay in returning the transcription information. If no TranscribeCallback is given, the recording will still be saved to the system and available either in your [Transcriptions Logs](https://www.telapi.com/logs/transcriptions) or via a REST List Transcriptions (ADD URL LINK) request. URL length is limited to 200 characters.","default":"","type":"string","name":"TranscribeCallback"},{"_id":"54513d9aa66f020800dbab57","ref":"","in":"body","required":false,"desc":"The HTTP method used to request the TranscribeCallback. Valid parameters are GET and POST - any other value will default to POST.","default":"POST","type":"string","name":"CallbackMethod"},{"_id":"54513d9aa66f020800dbab56","ref":"","in":"body","required":false,"desc":"Start point for slice transcription (in seconds).","default":"","type":"string","name":"SliceStart"},{"_id":"54513d9aa66f020800dbab55","ref":"","in":"body","required":false,"desc":"Duration of slice transcription (in seconds).","default":"","type":"string","name":"SliceDuration"},{"_id":"54513d9aa66f020800dbab54","ref":"","in":"body","required":false,"desc":"Specifies the transcription quality. Transcription price differs for each quality tier. See pricing page for details. Allowed values are \"auto\", \"hybrid\" and \"keywords\", where \"auto\" is a machine-generated transcription, \"hybrid\" is reviewed by a human for accuracy and \"keywords\" returns topics and keywords for given audio file.","default":"auto","type":"string","name":"Quality"}],"url":"/v2/Accounts/:AccountSid/Recordings/:RecordingSid/Transcriptions.json"},"isReference":false,"order":2,"body":"# **Response Parameters**\n\nResponse parameters are equal to those on [\"View Transcription\" API call](/v2/docs/view-transcription).\n\n# **Example cURL**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -X POST 'https://api.telapi.com/v2/Accounts/{AccountSid}/Recordings/{RecordingSid}/Transcriptions.json' -u '{AccountSid}:{AuthToken}'\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]","excerpt":"transcribes some recording","slug":"transcribe-recording","type":"endpoint","title":"Transcribe Recording"}

postTranscribe Recording

transcribes some recording

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

AccountSid:
required
string
Account SID.
RecordingSid:
required
string
Recording SID.

Body Params

TranscribeCallback:
string
The URL some parameters regarding the transcription will be passed to once it is completed. The longer the recording time, the longer the process delay in returning the transcription information. If no TranscribeCallback is given, the recording will still be saved to the system and available either in your [Transcriptions Logs](https://www.telapi.com/logs/transcriptions) or via a REST List Transcriptions (ADD URL LINK) request. URL length is limited to 200 characters.
CallbackMethod:
stringPOST
The HTTP method used to request the TranscribeCallback. Valid parameters are GET and POST - any other value will default to POST.
SliceStart:
string
Start point for slice transcription (in seconds).
SliceDuration:
string
Duration of slice transcription (in seconds).
Quality:
stringauto
Specifies the transcription quality. Transcription price differs for each quality tier. See pricing page for details. Allowed values are "auto", "hybrid" and "keywords", where "auto" is a machine-generated transcription, "hybrid" is reviewed by a human for accuracy and "keywords" returns topics and keywords for given audio file.

Result Format


Documentation

# **Response Parameters** Response parameters are equal to those on ["View Transcription" API call](/v2/docs/view-transcription). # **Example cURL** [block:code] { "codes": [ { "code": "curl -X POST 'https://api.telapi.com/v2/Accounts/{AccountSid}/Recordings/{RecordingSid}/Transcriptions.json' -u '{AccountSid}:{AuthToken}'", "language": "shell" } ] } [/block]