Quickstart - Audream API

1. Check authentication

curl https://audream-api.tulingbc.com/v1/auth/me \
  -H "Authorization: Bearer $AUDREAM_API_KEY"

2. Upload audio

Generate a UUID for the note, then submit the audio file:

NOTE_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')

curl -X POST \
  "https://audream-api.tulingbc.com/v1/notes/$NOTE_ID/transcription" \
  -H "Authorization: Bearer $AUDREAM_API_KEY" \
  -F "[email protected]" \
  -F "title=Product review" \
  -F "language=auto" \
  -F "auto_speaker_labeling_enabled=true"

The API returns 202 Accepted while processing runs asynchronously.

3. Poll transcription

curl "https://audream-api.tulingbc.com/v1/notes/$NOTE_ID/transcription" \
  -H "Authorization: Bearer $AUDREAM_API_KEY"

200 means transcription is complete.
202 means processing is still active.
422 means transcription failed; read the response detail.

4. Generate Insights

After transcription succeeds, send the transcription object to the Insights endpoint:

curl -X POST \
  "https://audream-api.tulingbc.com/v1/notes/$NOTE_ID/insights" \
  -H "Authorization: Bearer $AUDREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d @insights-request.json

See Audio to Insights for a complete Python example that performs this flow automatically.