Recording Transcription
A Transcription represents the transcribed text and metadata from a transcribed recording of a voice call.
The transcription text itself is the result of converting an audio recording to readable text. To generate transcriptions from call recordings, use the TwiML <Record> verb and set transcribe="true".
Your account will be charged if you request transcription for a recording, as this is a paid feature. Additionally, transcription is currently limited to recordings at most two minutes in length.
For pricing information, see the transcriptions pricing page.
Transcription properties
| Names in Node.js format | |
|---|---|
accountSid
|
この録音に関連する アカウント のユニーク ID です。 |
apiVersion
|
|
dateCreated
|
The date that this resource was created, in RFC 2822 format. |
dateUpdated
|
The date that this resource was last updated, in RFC 2822 format. |
duration
|
テキスト化された音声ファイルの長さ (秒) です。 |
price
|
The charge for this transcript in the currency associated with the account. Populated after the transcript is complete. Note, this value may not be immediately available. |
priceUnit
|
|
recordingSid
|
The unique id of the Recording that created this Transcription. |
sid
|
A unique 34-character string that identifies this resource. |
status
|
このトランスクリプションの状態を示す文字列です。 |
transcriptionText
|
トランスクリプションのテキスト内容です。 |
type
|
|
uri
|
このリソースのURIで、右記のURLに対する相対パスです |
Fetch a Transcription resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions/{Sid}.json
Twilio will respond with the JSON metadata for the Transcription. If you append ".txt" to the end of the Transcription resource's URI, Twilio will return only the text of the transcription:
/2010-04-01/Accounts/{AccountSid}/Transcriptions/{TranscriptionSid}.txtパラメーター
| Names in Node.js format | |
|---|---|
sid
必須
|
The unique SID that identifies this Transcription |
例 1
Read multiple Transcription resources
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions.json
Returns the full set of Transcriptions generated from all recordings in an account.
The list Twilio returns includes paging information.
例 1
You can also access a full list of Transcriptions directly from a given Recording by passing the RecordingSid to the Recording resource:
/2010-04-01/Accounts/{YourAccountSid}/Recordings/{RecordingSid}/Transcriptions.json
The cURL command to fetch Transcriptions from a Recording looks like this:
curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings/REXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Transcriptions.json \ -u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
If you prefer that Twilio responds with XML, change .json to .xml.
Delete a Transcription resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions/{Sid}.json
Delete a transcription from your account.
If the request is successful, Twilio will return HTTP 204 (No Content) with no body.
パラメーター
| Names in Node.js format | |
|---|---|
sid
必須
|
The unique SID that identifies this Transcription |
例 1
ヘルプが必要ですか？
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.