Make your first Speech to Text Request
To use the Speech-to-Text API, you need an API key. Your API key authenticates your requests and allows you to make API calls.
How to get your API key: Sign up for an account or log in to your existing account at the Developer API Platform. Your API key will be available in your account settings.
⚠️ Keep your API key secret — do not expose it publicly or share it. Treat it like a password.
Use one of the following examples to test your API key and transcribe text from speech. Replace YOUR_API_TOKEN with your actual API key.
Don't have an audio file? You can use our sample file below to test your request.
Download sample audio fileAPI="https://api.aldea.ai/v1/listen"TOKEN="YOUR_API_TOKEN"FILE=~/Downloads/aldea_sample.wavcurl -s -X POST "$API" \ -H "Authorization: Bearer $TOKEN" \ --data-binary @"$FILE"You can now integrate the API into your application. Check out the full documentation for more advanced features, authentication details, error handling, and migration guides.