Add Custom Guideline To Job¶
Add a set of guidelines for transcribers to follow when transcribing the media.
To add guidelines from a publicly accessible URL where the guidelines is the actual web page, make a GET request and specify the URL in the guidelines_url parameter and specify is_html parameter as true.
To add guidelines from a publicly accessible Download URL, make a GET request and specify the URL in the guidelines_url parameter (you do not need to specify is_html as false).
To add guidelines from a local file, make a POST request, DO NOT specify the guidelines_url parameter in the request URL. The guidelines should be uploaded with a multipart/form content type where the file is uploaded to form-field input file.
Note if you upload a custom guidelines set, when you call the perform_transcription api endpoint, you must call the option parameter with custom_special_handling set to true
HTTP Method
-
GET
/api/job/add_custom_guidelines (from URL)
¶
-
POST
/api/job/add_custom_guidelines (from local file)
¶
Query String Parameters - Required (always)
Name | Details | |
---|---|---|
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 |
Query String Parameters – Required (when adding guidelines from URL)
Name | Details | |
---|---|---|
guidelines_url | Description | The URL from which custom_guidelines will be obtained |
Allowed Values | URL Encoded String | |
Example | guidelines_url=https://cielo24.com/guidelines/ |
Query String Parameters – Required (when adding guidelines from URL where the web page is the guidelines)
Name | Details | |
---|---|---|
is_html | Description | flag to indicate whether url is download or webpage |
Allowed Values | true or false | |
Example | is_html=true |
Request Body — Required (when adding guidelines from local file)
Name | Details | |
---|---|---|
file | Description | Raw binary of a .txt file |
Allowed Values | not applicable | |
Example | Content-Disposition: form-data; name="file"; filename="file1.txt"
Content-Type: text/plain |
Request Body — Required (when passing in plaintext separated by new lines)
Name | Details | |
---|---|---|
guidelines_data | Description | plaintext separated by new lines |
Allowed Values | String | |
Example | guidelines_data=This is\nCustom Guideline |
Example Requests
GET /api/job/add_custom_guidelines?api_token=7ca5dc5c7cce449fb0fff719307e8f5f
&job_id=64bea283eff6475ea6596027a6ba0929
&guidelines_url=https%3A%2F%2Fcielo24.com%2Fguidelines%2F
&is_html=true HTTP/1.1
POST /api/job/add_custom_guidelines?api_token=7ca5dc5c7cce449fb0fff719307e8f5f
&job_id=64bea283eff6475ea6596027a6ba0929 HTTP/1.1
Content-Length: 1037
Expect: 100-continue
Content-Type: multipart/form-data; boundary=------------------------d74496d66958873e
Content-Disposition: form-data; name="file"; filename="file.txt"
Content-Type: text/plain
contents of the file here
--------------------------d74496d66958873e--
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{"CUSTOM_GUIDELINES_STORED": {"full_html": false, "storage_data": {"path": "public/original-media/5523e8c8d34444c38e675e1f46f2b55c.txt", "account": "1eff263d871f460f86f5a4d133a7e727", "bucket": "cielo24-dev-dev-main-storage", "size": 1037}}}