Quickstart: How To Test SR

This guide walks you through testing the SESTEK Speech Recognition (SR) API using the official Postman collection. The collection contains two pre-configured requests:

ℹ️ This collection only covers file-based dictation transcription. For grammar-based recognition or real-time (WebSocket) streaming, see Transcribe a File and Transcribe in Real-time.

Prerequisites

• Postman installed.
• A valid Client ID and Client Secret for the SR service. If you don't have these yet, contact your SESTEK Sales Operations contact. See Authentication for details on how credentials are provisioned.

Step 1: Download and Import the Collection

To get started, ensure you have Postman installed. If not, download it here:

🔗 Download Postman

Once Postman is installed, download the SESTEK Speech Recognition Postman collection below and import it:

📂 SESTEK Speech Recognition Postman Collection

Speech Recognition.postman_collection.json

After importing, you should see two ready-to-use requests: Get Integration Token and SR Basic.

Step 2: Generate an Access Token

Open the Get Integration Token request. It is a POST to the identity endpoint with an x-www-form-urlencoded body:

Endpoint

POST https://identity.ldm.knovvu.com/connect/token

Body parameters

Replace the placeholder values [client_id] and [client_secret] with your own credentials, then click Send.

Example response

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 31536000,
  "token_type": "Bearer",
  "scope": "Ldm_Integration"
}

Copy the access_token value. You'll need it in the next step. It is valid for 365 days; see Authentication for renewal recommendations.

Step 3: Configure the SR Basic Request

Open the SR Basic request. Its Authorization tab is already set to Bearer Token. Paste the access_token from Step 2 into the token field.

Endpoint

POST https://srapi.knovvu.com/v1/speech/dictation/request

The host above (srapi.knovvu.com) is the Paris region endpoint. If you were assigned a different region, replace the host with your region's URL. See API Region URLs.

Headers

Body

The body mode is set to binary. Click Select File and choose the audio file you want to transcribe.

Click Send. The response contains the recognized text along with confidence scores and timing information. See Transcribe a File for the full response schema.

Equivalent cURL Commands

If you prefer not to use Postman, both requests translate directly to cURL:

Get token

curl -X POST https://identity.ldm.knovvu.com/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=[client_id]" \
  -d "client_secret=[client_secret]" \
  -d "grant_type=client_credentials" \
  -d "scope=Ldm_Integration"

Transcribe a file

curl -X POST https://srapi.knovvu.com/v1/speech/dictation/request \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: audio/wave" \
  -H "ModelName: English" \
  -H "ModelVersion: 1" \
  -H "Tenant: Default" \
  -H "SendAudioDownloadLink: true" \
  --data-binary "@/path/to/your/audio.wav"

Related Documentation

• Authentication
• API Region URLs
• Language Models
• Transcribe a File
• Transcribe in Real-time