Skip to main content

Step 1: Get Your API Key

In the Smallest AI Console, go to Settings → API Keys and click Create API Key. API Keys settings page with Create API Key button highlighted Create New API Key dialog with name field Copy the key and export it:
export SMALLEST_API_KEY="your-api-key-here"
New to Smallest AI? Sign up here first.

Step 2: Transcribe Audio

Here’s the sample audio we’ll transcribe: Paste this cURL — no install required:
curl -X POST "https://api.smallest.ai/waves/v1/pulse/get_text?language=en" \
  -H "Authorization: Bearer $SMALLEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/smallest-inc/cookbook/raw/main/speech-to-text/getting-started/samples/audio.wav"}'
You’ll get back:
{
  "transcription": "This is a sample audio file for testing speech to text transcription with the Pulse API."
}

Step 3: Build It Into Your App

curl -X POST "https://api.smallest.ai/waves/v1/pulse/get_text?language=en" \
  -H "Authorization: Bearer $SMALLEST_API_KEY" \
  -H "Content-Type: audio/wav" \
  --data-binary "@audio.wav"

Step 4: Explore Features

Real-Time Transcription

Stream audio via WebSocket for live transcription.

Speaker Diarization

Identify and label different speakers.

Word Timestamps

Precise timing for each transcribed word.

Emotion Detection

Analyze emotional tone in speech.
Full endpoint spec: Pulse API Reference

Need Help?

Join Discord

Ask questions and get help from the community.
Or email support@smallest.ai.