Quickstart

Transcribe your first audio file in under 60 seconds with Pulse STT.

Step 1: Get Your API Key

In the Smallest AI Console, go to Settings → API Keys and click Create API Key.

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 (file upload)

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 [e-mail].