Getting Started (Video to Text)

To convert video to text using Symbl.ai there are 3 steps - authenticate, process conversation, and generate a transcript. To test this transcription, you can either use the API right from Symbl docs, or you can use our Symbl.AI Postman.

Steps for both are listed below -
 
From Symbl docs
Authenticate

• Go to Generate token and follow the steps to generate the token. Copy the access token from the response to use in the next steps.

Process conversation

• Go to Submit Video to process an ".mp4" file you have stored locally. Paste the token from the previous Authentication step where it says “Bearer” on the right. Under "Body Params" click the icon, and select the ".mp4" that you would like to generate a transcript from. Then click "Try it!". Copy both the "jobId" and "conversationId" from the response.
• Go to Get Job Status and paste the token from the previous Authentication step where it says “Bearer” on the right. Then next to "jobId" paste the "jobId" returned in the Submit Video response. Then click "Try it!". If you see ["status": "in_progress"] in your response, wait 2-3 minutes and then click "Replay Request". Do not proceed to the next step until you see ["status": "complete"] in your response

Get Messages (Transcript)

• Go to Get messages, use the same bearer token as before on the right, and put in the "conversationId" from the previous step. Click “Try It!” to get all messages and timestamp information for that conversationId. For a detailed breakdown of the response body, at the bottom of Get messages click on the "200" status.

 
From Postman
Follow this guide to install Postman and import Symbl.ai API collection. It is best to use the Postman Desktop app as that is not restricted by browser limitations and enables you to upload large audio/video files.
Authenticate

• Go to Symbl API > Authentication > Generate Token. Click on the “Body” tab and enter the values for “appId” and “appSecret” which you can find on the Symbl.ai platform home page. Click “Send”.

Process conversation

• Go to Symbl API > Async API > Video - Submit New Video File to process an ".mp4" file you have stored locally
• Go to the “Body” tab and click "Select File". Select the local ".mp4" file that you would like to generate a transcript from. Click "Send".
• Go to Symbl API > Async API > Check Request Status (Job Status). Click "Send". If you see ["status": "in_progress"] in your response, wait 2-3 minutes and then click "Send" again. Do not proceed to the next step until you see ["status": "complete"] in your response

Get Messages (Transcript)

• Go to Symbl API > Conversation APIs > GET Messages (Transcript). Click “Send” to get all messages and timestamp information for the ".mp4" file from the previous step
• If you just want a long, continuous text transcript without details timestamp information, go to Symbl API > Conversation APIs > POST Formatted Transcript. Click "Send" to get one continuous text transcript for the ".mp4" file from the previous step, instead of each message broken down with related timestamp information.