Perform Transcription

Request that transcription be performed on the specified job. A callback URL, if specified, will be called when the transcription is complete. See callback documentation for details.

HTTP Method

GET /api/job/perform_transcription

Query String Parameters — Required

Name Details
v Description The version of the API to use
Allowed Values 1
Example v=1
api_token Description The API token used for this session
Allowed Values Hex String
Example api_token=7ca5dc5c7cce449fb0fff719307e8f5f
job_id Description The ID of the job
Allowed Values Hex String
Example job_id=64bea283eff6475ea6596027a6ba0929
transcription_fidelity Description The desired fidelity of the transcription
Allowed Values Fidelity Enumeration
Example transcription_fidelity=PREMIUM

Query String Parameters — Optional

Name Details
callback_url
A URL with query string which will be called on completion.
If submitting the callback_url as a query string parameter, rather than
a value in the POST data, the callback_url should be URL encoded.
The callback URL can contain tags that will be replaced with
job specific data when the callback is called.
Below is the list of tags that are supported:
  {job_id} The job UUID
  {job_name} The job name
  {elementlist_version} The ElementList version
  {iwp_name} The Interim Work Product name associated with this
          ElementList version
Allowed Values URL Encoded String
Example callback_url=http%3A%2F%2Fdomain.com%2Fpath
options
A job options dictionary. See next section for details.
Allowed Values Stringified dictionary
Example options={"notes":"test","speaker_id":true}
priority
The desired priority of the transcription.
Allowed Values Priority Enumeration
Example priority=STANDARD
target_language
An RFC 5646 language code to translate this job into.
If not specified, then no translation will be performed.
If specified, but the language code specified matches the language
code on the job request, then no translation will be performed.
Allowed Values RFC 5646 Language code
Example target_language=de
turnaround_hours
The number of hours after submission that the job will be returned.
If not specified, it will be set to a default based on the value of
the priority parameter. The defaults are 24 and 48 for the
PRIORITY and STANDARD priorities respectively. If you
request a smaller number of hours than the default for the
priority you have selected, the priority will be automatically
changed. For example if you request a turnaround_hours of 16
with a priority of STANDARD, the priority will be automatically,
and silently, changed to PRIORITY.
Allowed Values Integer
Example turnaround_hours=36
Job Options
The following options can be provided as a stringified dictionary.
The resulting string will be the value of the options query parameter.
Example: options={"notes":"test_note","speaker_id":true}
Name Details
customer_approval_steps
Requires your approval of a job at specified points in the
workflow. When the job is ready for approval you will be emailed
a link that will take you to a web based tool you can use to view,
edit and approve the job. You may request approval at two points
in the workflow: before translation and before the job is returned.
Allowed Values [ TRANSLATION, RETURN ]
Default Value []
Example customer_approval_steps=[TRANSLATION]
customer_approval_tool
Determines which web based tool to use for viewing, editing
and approving jobs.
Allowed Values [ AMARA, CIELO24 ]
Default Value CIELO24
Example customer_approval_tool=CIELO24
custom_metadata
A JSON dictionary of key value pairs. These will be used
as substitution strings when building the callback URL and
custom DFXP caption header.
Allowed Values Single level JSON dictionary
Default Value {}
Example custom_metadata={"key":"value"}
notes
Allows you to provide text that will be displayed to
the transcriber when the job is processed.
An HTML included will be escaped.
Allowed Values String ( <= 1000 characters)
Default Value “”
Example notes=sometext
return_iwp
Allows you to receive additional callbacks when interim
versions of the job are completed. If you specified a
callback_url, then a callback will sent for FINAL
regardless of the value of this option.
Allowed Values IWP Enumeration
Default Value []
Example return_iwp=[MECHANICAL,FINAL]
generate_media_intelligence_iwp
Requests that media intelligence be generated for the specified
interim/final versions of the transcript. Media intelligence data is
added to the ElementList and can be retrieve using the
get_elementlist API call.
See ElementList for details.
Allowed Values IWP Enumeration
Default Value []
Example generate_media_intelligence_iwp=[MECHANICAL,FINAL]
speaker_id
Requests that speaker names be identified.
Allowed Values Boolean
Default Value false
Example speaker_id=true

Responses

HTTP Code Details
200 Description Success
Contents
{
  "TaskId" : "Encoded Task ID"
}
400 Description An error occurred
Contents Error description (see Error Format for details)

Example Requests

GET /api/job/perform_transcription?v=1
&api_token=7ca5dc5c7cce449fb0fff719307e8f5f
&job_id=64bea283eff6475ea6596027a6ba0929
&transcription_fidelity=PREMIUM&priority=STANDARD HTTP/1.1
Host: api.cielo24.com

Example Response

HTTP/1.1 200 OK
Content-Type: application/json

{ "TaskId" : "41ec7d23fb4b45f9b48a13d0b7283bf2" }