{"__v":0,"_id":"54515b15a66f020800dbabcf","category":{"__v":4,"_id":"54513cc014af501a00b50d24","pages":["5452381304160008005b1c99","5452455e04160008005b1cd9"],"project":"542dbe0ecb19820800c1f4d7","version":"542ecc0a6b0eb6080066ca77","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-29T19:15:12.521Z","from_sync":false,"order":17,"slug":"transcriptions","title":"Transcriptions"},"editedParams":true,"editedParams2":true,"is_link":false,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","user":"542dc547cb19820800c1f4f1","version":{"__v":29,"_id":"542ecc0a6b0eb6080066ca77","forked_from":"542dbe0fcb19820800c1f4da","project":"542dbe0ecb19820800c1f4d7","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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-29T21:24:37.812Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":true,"method":"post","results":{"codes":[{"name":"","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}      ","language":"json","status":200},{"name":"","code":"{\n    \"status\": 404,\n    \"message\": \"The requested resource was not found: /v2/Accounts/bad/bad_response.json\"\n}","language":"json","status":404}]},"try":true,"auth":"optional","params":[{"_id":"54515b15a66f020800dbabd6","ref":"","in":"path","required":true,"desc":"Account SID.","default":"[[app:account_sid]]","type":"string","name":"AccountSid"},{"_id":"54515b15a66f020800dbabd5","ref":"","in":"body","required":false,"desc":"URL where the audio to be transcribed is located.","default":"","type":"string","name":"AudioUrl"},{"_id":"54515b15a66f020800dbabd4","ref":"","in":"body","required":false,"desc":"URL that will be requested when the transcription has finished processing.","default":"","type":"string","name":"TranscribeCallback"},{"_id":"54515b15a66f020800dbabd3","ref":"","in":"body","required":false,"desc":"Start point for slice transcription (in seconds).","default":"","type":"string","name":"SliceStart"},{"_id":"54515b15a66f020800dbabd2","ref":"","in":"body","required":false,"desc":"Duration of slice transcription (in seconds).","default":"","type":"string","name":"SliceDuration"},{"_id":"54515b15a66f020800dbabd1","ref":"","in":"body","required":false,"desc":"Specifies the HTTP method to use when requesting the TranscribeCallback URL. Allowed values are \"POST\" and \"GET\".","default":"","type":"string","name":"CallbackMethod"},{"_id":"54515b15a66f020800dbabd0","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/Transcriptions.json"},"isReference":false,"order":3,"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}/Transcriptions.json' -u '{AccountSid}:{AuthToken}' -d 'AudioUrl=http://valid-url-here.com/audio.mp3'\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]","excerpt":"transcribes an audio file on some URL","slug":"transcribe-audio-url","type":"endpoint","title":"Transcribe Audio Url"}

postTranscribe Audio Url

transcribes an audio file on some URL

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

AccountSid:
required
string{{keys('account_sid')}}
Account SID.

Body Params

AudioUrl:
string
URL where the audio to be transcribed is located.
TranscribeCallback:
string
URL that will be requested when the transcription has finished processing.
SliceStart:
string
Start point for slice transcription (in seconds).
SliceDuration:
string
Duration of slice transcription (in seconds).
CallbackMethod:
string
Specifies the HTTP method to use when requesting the TranscribeCallback URL. Allowed values are "POST" and "GET".
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}/Transcriptions.json' -u '{AccountSid}:{AuthToken}' -d 'AudioUrl=http://valid-url-here.com/audio.mp3'", "language": "shell" } ] } [/block]