Skip to main content
POST
/
stt
/
v1
/
transcribe
curl --request POST \
  --url https://api.inworld.ai/stt/v1/transcribe \
  --header "Authorization: Basic $INWORLD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "transcribeConfig": {
      "modelId": "groq/whisper-large-v3",
      "audioEncoding": "LINEAR16",
      "language": "en-US",
      "sampleRateHertz": 16000,
      "numberOfChannels": 1
    },
    "audioData": {
      "content": "<YOUR_AUDIO>"
    }
  }'

{
  "transcription": {
    "transcript": "Hey, I just wanted to check in on the delivery status for my order.",
    "isFinal": true,
    "wordTimestamps": []
  },
  "usage": null
}

curl --request POST \
  --url https://api.inworld.ai/stt/v1/transcribe \
  --header "Authorization: Basic $INWORLD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "transcribeConfig": {
      "modelId": "groq/whisper-large-v3",
      "audioEncoding": "LINEAR16",
      "language": "en-US",
      "sampleRateHertz": 16000,
      "numberOfChannels": 1
    },
    "audioData": {
      "content": "<YOUR_AUDIO>"
    }
  }'

{
  "transcription": {
    "transcript": "Hey, I just wanted to check in on the delivery status for my order.",
    "isFinal": true,
    "wordTimestamps": []
  },
  "usage": null
}

Authorizations

​
Authorization
string
header
required

Your authentication credentials. For Basic authentication, please populate Basic $INWORLD_API_KEY

Body

application/json

Request message for the synchronous TranscribeSpeech API.

​
transcribeConfig
object
required

Configuration for transcribing audio. Contains model selection, audio format settings, and optional feature configurations.

​
audioData
object
required

Container for raw audio data bytes.

Response

A successful response.

​
transcription
object

Represents the result of a speech-to-text transcription. May be an interim (partial) result or a final result depending on the is_final field.

​
usage
object

Usage metrics for billing and monitoring purposes. Coming soon — this field is not yet populated and may return null.