Skip to main content

​
Step 1: Sign Up & Get Your API Key

  1. Visit the platform and sign up for an account or log in if you already have an account.
  2. Navigate to API Key tab in your account dashboard.
  3. Create a new API Key and copy it.
  4. Export the API Key in your environment with the name SMALLEST_API_KEY, ensuring that your application can access it securely for authentication.

​
Step 2: Install Dependencies

To install the required library: 
pip install requests

​
Step 3: Make Your First API Call

Here is a basic example of how to use Python to transcribe an audio file: 
import os
import requests

API_KEY = os.environ.get("SMALLEST_API_KEY")

response = requests.post(
    "https://waves-api.smallest.ai/api/v1/pulse/get_text",
    params={"model": "pulse", "language": "en"},
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "audio/wav",
    },
    data=open("audio.wav", "rb").read(),
    timeout=120
)

result = response.json()
print(result["transcription"])
Replace YOUR_API_KEY with the API key you obtained in Step 1.

​
Step 4: Explore More Features

For detailed documentation on all available features and endpoints, visit our API Reference.

​
Need Help?

If you have any questions or need assistance, please contact our support team at [email protected].