@@ -57,6 +57,30 @@ and `custom_vocabulary_id` as optional parameters.
5757
5858The url submission option also supports authentication headers by using the ` source_config ` option.
5959
60+ You can request transcript summary.
61+
62+ ``` python
63+ # submitting a human transcription jobs
64+ job = client.submit_job_url(" https://example.com/file-to-transcribe.mp3" ,
65+ language = ' en' ,
66+ summarization_config = SummarizationOptions(
67+ formatting_type = SummarizationFormattingOptions.BULLETS
68+ ))
69+ ```
70+
71+ You can request transcript translation into up to five languages.
72+
73+ ``` javascript
74+ job = client .submit_job_url (" https://example.com/file-to-transcribe.mp3" ,
75+ language= ' en' ,
76+ translation_config= TranslationOptions (
77+ target_languages: [
78+ TranslationLanguageOptions (" es" , NlpModel .PREMIUM ),
79+ TranslationLanguageOptions (" de" )
80+ ]
81+ ));
82+ ```
83+
6084All options are described in the request body of the
6185[ Submit Job] ( https://docs.rev.ai/api/asynchronous/reference/#operation/SubmitTranscriptionJob ) endpoint.
6286
@@ -131,20 +155,42 @@ transcript_json = client.get_transcript_json(job.id)
131155
132156# or as a python object
133157transcript_object = client.get_transcript_object(job.id)
158+
159+ # or if you requested transcript translation(s)
160+ transcript_object = client.get_translated_transcript_object(job.id,' es' )
134161```
135162
136163Both the json and object forms contain all the formation outlined in the response
137164of the [ Get Transcript] ( https://docs.rev.ai/api/asynchronous/reference/#operation/GetTranscriptById ) endpoint
138165when using the json response schema. While the text output is a string containing
139166just the text of your transcript
140167
168+ ### Getting transcript summary
169+
170+ If you requested transcript summary, you can retrieve it as plain text or structured object:
171+
172+ ``` python
173+ # as text
174+ summary = client.get_transcript_summary_text(job.id)
175+
176+ # as json
177+ summary = client.get_transcript_summary_json(job.id)
178+
179+ # or as a python object
180+ summary = client.get_transcript_summary_object(job.id)
181+
182+ ```
141183### Getting captions output
142184
143185You can also get captions output from the SDK. We offer both SRT and VTT caption formats.
144186If you submitted your job as speaker channel audio then you must also provide a ` channel_id ` to be captioned:
145187
146188``` python
147189captions = client.get_captions(job.id, content_type = CaptionType.SRT , channel_id = None )
190+
191+ # or if you requested transcript translation(s)
192+ captions = client.get_translated_captions(job.id, ' es' )
193+
148194```
149195
150196### Streamed outputs
0 commit comments