Rev.ai API Documentation
Rev.ai provides quality speech-text recognition via a RESTful API.
Base Endpoint
The base url for this version of the API is https://api.rev.ai/v1
Quick Start
- Get your Access Token: Generate your access token on the settings page of your account.
- Submit a File:
curl -X POST \ -H "Authorization: Bearer $REV_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"media_url": "audio_file_url"}'
Get Your Transcript
curl -X GET \
-H "Authorization: Bearer $REV_ACCESS_TOKEN" \
-H "Accept: application/vnd.rev.transcript.v1.0+json"
Webhooks
If the optional `callback_url` is provided, the API will make an HTTP POST request to the `callback_url`...
Async API Limits
- - 10,000 transcription requests submitted every 10 minutes
- - 500 transcriptions processed every 10 minutes
Error Handling
The API indicates failure with 4xx and 5xx HTTP status codes...
Retry Failed Requests
Status Code | Error |
---|---|
429 | Too Many Requests |
502 | Bad Gateway |
503 | Service Unavailable |
504 | Gateway Timeout |
Contact [email protected] for further assistance.