-
Send an email to [email protected] requesting a sandbox API login.
-
Download our API libraries: Python 3.6+, Java, C#, Javascript.
-
Use the sandbox credentials you received from support and the libraries to connect to our API.
For testing, a sandbox API is provided at https://sandbox.cielo24.com.
The sandbox provides a testing platform for development, where no real processing is performed.
Transcript/caption requests made to the sandbox will return a pre-prepared sample, the data will not match the content or length of media you submitted.
However, the transcript/caption will be formatted as you request in your get_transcript and get_caption call.
The sandbox API will make URL callbacks, if requested, a few seconds after the call to perform_transcription is made.
The production API can be accessed from the following location: https://api.cielo24.com.
Account management is largely performed outside of the API. To set up a new production account please register for an account at http://www.cielo24.com. To request a sandbox account, email to [email protected].
Upon request, multiple accounts may be created for you to control access or simplify billing. These accounts will be related to one another by parent-child relationships. An unlimited number of relationship levels may be created, i.e. parent, child, grandchild.
Each sub-account is a normal account with its own list of jobs and media. Access is restricted to the jobs in an account and that account's descendants. For example, the credentials for a child account may be used to create and/or access jobs in a grandchild account, but not in a parent or sibling accounts.
For the most part, the access to the jobs of sub-accounts is transparent, as most API calls operate using a job ID. Simply login as a parent, and access jobs of the sub-account as if they belonged to the parent. However, for some API calls, such as Create Job and List Jobs, you will need to pass an additional parameter to specify the sub account you want to use.
If you are interested in using sub-accounts, please contact [email protected] for more information.
Processing requests such as transcription are not completed immediately. As such, the interface supports the use of a callback URL that is provided by the application developer. Once the job has completed, the API calls this callback URL to inform the application that the specific job has been completed. We make a GET request to the callback URL. HTTPS and embedded basic HTTP auth URLs are supported. We will retry callbacks three times over a 30 minute period if the remote server doesn't return a HTTP success code (200 OK.) You may wish to include a unique identifier in the URL so you can tell which request has completed, or you can request that we send additional data with the callback. See the callback_url parameter of each method for a list of the data that can be sent.
For example: http://www.yourdomain.com/cielo24/request_complete?job_id=1234
If a callback URL is not practical, the application can poll the interface by requesting the status of a given task that is associated with a given job. The task status will indicate COMPLETE when the task is done.
We support transcription to and from any of the following languages. However, please note that if English is not a source or target language, an additional translation will incur as we will have to generate a translation from the source language into English and then from English into the Target language. This will result in increased charges.
Transcription and translation are supported in the following languages for PROFESSIONAL fidelity jobs (volume may vary contact support <mailto:[email protected]>_ for more information):
| Language | IETF Language Code |
|---|---|
| Arabic | ar |
| Chinese - Mandarin (Traditional) | zh-tw |
| Chinese - Mandarin (Simplified) | zh-cmn |
| Chinese - Cantonese (Traditional) | zh-yue |
| Czech | cz |
| Danish | dk |
| Dutch | nl |
| English | en |
| French | fr |
| French (Canada) | fr-ca |
| Finnish | fi |
| German | de |
| Greek | gr |
| Hebrew | he |
| Hindi | hi |
| Indonesian | id |
| Italian | it |
| Japanese | ja |
| Korean | ko |
| Norwegian | no |
| Polish | pl |
| Portuguese (Brazil) | pt |
| Portuguese (Portugal) | pt-pt |
| Russian | ru |
| Spanish | es |
| Spanish (Spain) | es-es |
| Slovak | sk |
| Swedish | se |
| Thai | th |
| Turkish | tr |
| Vietnamese | vn |
Transcription is supported in the following languages for MECHANICAL fidelity jobs:
| Language | IETF Language Code |
|---|---|
| Arabic | ar |
| Chinese - Mandarin (Traditional) | zh-tw |
| Chinese - Mandarin (Simplified) | zh-cmn |
| Danish | dk |
| Dutch | nl |
| English | en |
| French | fr |
| German | de |
| Hebrew | he |
| Hindi | hi |
| Indonesian | id |
| Italian | it |
| Japanese | ja |
| Korean | ko |
| Malay | ms |
| Portuguese | pt |
| Russian | ru |
| Spanish | es |
| Thai | th |
| Turkish | tr |