To start integrating Reverie’s APIs into your application, you’ll need two credentials:

  • REV-API-KEY: Your unique API key for authentication
  • REV-APP-ID: Identifies your registered application

These are required in the header of every request made to our APIs.

​
Steps to Generate Your API Key

  1. Sign Up : Visit RevUp Developer Portal and create a free developer account.

  2. Automatic API Key Generation : As soon as you register, your first API Key and App ID are automatically created — no extra steps required.

  3. Access Credentials : Your APP ID and API Key will be visible in the dashboard for use in your integrations.

​
How to Use the Credentials

To authenticate your requests, include the REV-APP-ID & REV-API-KEY in the headers of your HTTP requests.

REV-API-KEY: <YOUR-API-KEY>
REV-APP-ID: <YOUR-APP-ID>

​
Test your first API call

Here are the cURL requests of all the APIs.

curl --location --request POST 'https://revapi.reverieinc.com/upload' \
--header 'src_lang: hi' \
--header 'domain: generic' \
--header 'REV-API-KEY: <YOUR API KEY>' \
--header 'REV-APPNAME: stt_batch' \
--header 'REV-APP-ID: <YOUR API-ID>' \
--header 'subtitles: true' \
--form 'file=@"<File Path>"'

​
Best Practices for API Key Management

  1. Secure Storage: Store API keys in secure environments like encrypted storage or secrets management tools (e.g., AWS Secrets Manager or Azure Key Vault) to avoid exposure in source code or version control systems.

  2. Limit Key Permissions: Use the principle of least privilege by restricting the permissions associated with the API key. Only allow access to the specific API endpoints and actions required, reducing potential security risks

  3. Monitor Usage and Set Limits: Continuously monitor API key usage for abnormal activity and implement rate limits to prevent abuse or overuse, ensuring better security and performance.