Better integrate your software with Autosubtitle Online
The Autosubtitle Online API is available to all paying users. With the API, users can programmatically upload their media files for transcription and download the resulting transcript as SRT. Read Autosubtitle API documentation details below.
Autosubtitle’s API keys are open to all users, no matter you are paid subscribers or a trial account, you can request an API key if you need it. And you can access your API key here: https://autosubtitle.online/platform/#/myinfo
>>How to generate? Follow below steps.
All Autosubtitle API operations must be authorized with your access_key.
The current version of API is v1. All the operations use the following base URL: api.autosubtitle.online
If you use the Enhanced version of transcription, please check the language code of Google. Contact us to request help.
Below are all the possible error codes you may encounter when you use the API.
| Code | Message | Description |
| 1000 | Success! | Your operation is successful. |
| 1001 | Invalid Access Key! | We do not recognize your Access key. Check your access key and resubmit. |
| 1002 | Exceed Upload Limit! | Your uploaded file is beyond the upload limit. |
| 1003 | Format Error! | Your uploaded file cannot match up the supported format. |
| 1004 | Invalid Video! | Your uploaded video does not exist. |
| 1005 | Upload Failed! | Your file has failed to upload. Please try again or upload again. |
| 1006 | URL Video Download Failed! | We cannot download the video via your paste URL. |
| 2001 | Missing Video Tag! | Your uploaded video has no UNIQUE “Tag”. Please upload again. |
| 2002 | Video Not Upload! | You have not uploaded the video yet. |
| 2003 | User Time Insufficient! | Your subscription time is insufficient, please order more first. |
| 2004 | Video Failed to Load! | We cannot catch the video screenshot for preview. |
| 2005 | Video Parsing Failed! | Your video’s audio or noise reduction has failed. Please try again or contact our developer. |
| 2006 | Video Transmission Failed! | Your video has failed to transmit to the server. |
| 2007 | Transcription Failed! | Your video has failed to transcription. |
| 2008 | Subtitle Recognition Failed! | We cannot recognized your video’s subtitles. |
| 2009 | Subtitle Generation Failed! | We cannot generate subtitles to your videos. |
| 2010 | Email Sending Failed! | We cannot send email to your provided email address. |
| 3001 | Subtitle Download Failed! | You do not upload or recognize. Please check once whether uploaded or recognized. |
{"err_code": 1001, "err_msg": "Invalid Access Key"!}| HTTP Method | POST |
| Endpoint | /p/tts/upload_api |
| Returns | Media JSON for the newly uploaded file. If succeed, there will be an unique “tag” for each file. |
| Field | Type | Required | Content-Type | Description |
| user_id | string | ✔ | application/x-www-form-urlencoded | ID of every single user. |
| access_key | string | ✔ | application/x-www-form-urlencoded | The permission of Autosubtitle API. |
| url | string | application/x-www-form-urlencoded | The media URL you want to download. |
{“tag”: [“6e3c7df2-606f-11eb-8e48-495cdaef92d0”], “err_code”: 1000, “err_msg”: “Success!”}
| HTTP Method | POST |
| Endpoint | /p/tts/generate_subtitles_api |
| Returns | Subtitle JSON for the uploaded file, only including success status code “1000”. |
| Field | Type | Required | Default | Content-Type | Description |
| user_id | string | ✔ | application/x-www-form-urlencoded | ID of every single user. | |
| access_key | string | ✔ | application/x-www-form-urlencoded | The permission of Autosubtitle API. | |
| is_email | boolean | False | application/json | If sending notification email or not. | |
| is_noise_reduction | boolean | False | application/json | If using noise reduction or not. | |
| is_enhanced | boolean | False | application/json | If choosing enhanced type or not. | |
| filetag | string | ✔ | application/json | Returned tag from /p/tts/upload_api, which is used to identified each uploaded file. | |
| slan | string | ✔ | en | application/json | Source language code. |
| is_translate | boolean | False | application/json | If translation or not. | |
| tlan | string | zh | application/json | Target language code. |
{“err_code”: 1000}
| HTTP Method | GET |
| Endpoint | /p/tts/download_subtitles_api |
| Returns | Subtitle data flow which can be downloaded. |
| Field | Type | Required | Default | Content-Type | Descrption |
| user_id | string | ✔ | application/x-www-form-urlencoded | ID of every single user. | |
| access_key | string | ✔ | application/x-www-form-urlencoded | The permission of Autosubtitle API. | |
| filetag | string | ✔ | application/x-www-form-urlencoded | Returned tag from /p/tts/upload_api, which is used to identified each uploaded file. | |
| fmt | string | ✔ | srt | application/x-www-form-urlencoded | The export format of subtitles. |
| subtitle_type | string | ✔ | source | application/x-www-form-urlencoded | The type of subtitle languages. “source”=source language subtitle; “target”=target language subtitle; “double”= bilingual subtitles |
