Add transcript To Job¶

Add a transcript to an existing job.

not supported for every workflow, talk to your account manager for more details before using this feature

To add transcript from a publicly accessible URL, make a GET request and specify the URL in the transcript_url parameter.

To add transcript from a local file, make a POST request. Do NOT specify the transcript_url parameter in the request URL. No content-type should be included in the HTTP header. Upload the transcript directly inline as the body of the request. The transcript should be uploaded as raw binary, no encoding (base64, hex, etc) is required. Chunk-transfer encoding is NOT supported. If uploading large files (500 mb and up), specify the Content-Length in the header. File size is limited to 10 gb.

HTTP Method

GET /api/job/add_transcript (from URL)¶

POST /api/job/add_transcript (from local file)¶

Query String Parameters — Required (always)

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 to which transcript is added
	Allowed Values	Hex String
	Example	`job_id=64bea283eff6475ea6596027a6ba0929`
format	Description	The format of the transcription file
	Allowed Values	String text, srt, vtt, dfxp
	Example	`format=text`

Query String Parameters — Required (when adding transcript from URL)

Name	Details
transcript_url	Description	The URL from which transcript will be obtained
	Allowed Values	URL Encoded String
	Example	`transcript_url=http%3A%2F%2Fwww.domain.com%2Fvideo_script.txt`

Request Body — Required (when adding transcript from local file)

Responses

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

Example Requests

GET /api/job/add_transcript?v=1&api_token=7ca5dc5c7cce449fb0fff719307e8f5f
&job_id=64bea283eff6475ea6596027a6ba0929
&transcript_url=http%3A%2F%2Fwww.domain.com%2Fvideo_script.txt HTTP/1.1
Host: api.cielo24.com

POST /api/job/add_transcript?v=1&api_token=7ca5dc5c7cce449fb0fff719307e8f5f
&job_id=64bea283eff6475ea6596027a6ba0929 HTTP/1.1
Host: api.cielo24.com
Content-Length: 645809838
Body: raw binary

Example Response

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

{ "TaskId" : "41ec7d23fb4b45f9b48a13d0b7283bf2" }