Skip to main content
This guide walks you through making your first audio analysis request with Dolva. You’ll authenticate with your API token and send an audio file to either the cognitive or emotion endpoint. The whole flow takes less than 5 minutes.

​
Prerequisites

  • A Dolva account and API token (sign up at dolva.ai)
  • An audio file in a supported format (WAV, MP3, or similar — see Audio Requirements)
  • curl, Python, or another HTTP client
1

Get your API token

Log in to your Dolva account at dolva.ai and copy your API token from the dashboard. You’ll use it as a Bearer token in the Authorization header.
2

Choose an analysis type

Decide whether you want cognitive or emotional signal analysis. Both endpoints accept the same audio upload format — you can call both on the same recording.
  • /v1/analyze/cognitive — cognitive load, clarity, and processing signals
  • /v1/analyze/emotion — emotional state and valence signals
3

Upload your audio file

Send a multipart/form-data POST request with your audio file in the audio field.
curl -X POST https://api.dolva.ai/v1/analyze/cognitive \
  -H "Authorization: Bearer dv-xxxxxxxx" \
  -F "audio=@/path/to/your/recording.wav"
4

Read the response

Dolva returns a JSON object with the analysis results. A successful response has HTTP status 200.
Example Response
{
  "status": "ok",
  "signals": {
    "cognitive_load": 0.72,
    "clarity": 0.85
  }
}
The exact fields in the response depend on the model version and audio content. See Interpreting Results for a full breakdown.

​
Next Steps

Authentication

Understand Bearer token authentication in detail.

Interpreting Results

Learn what each signal field means.

Error Handling

Handle validation errors and API failures gracefully.

API Reference

Full reference for all endpoints and parameters.