stt [legacy]

This is the old version of our STT API, which has been known to experience failures due to timeouts. To avoid such issues, we recommend using the new endpoints described on other pages in the Speech-to-Text category.

The migration won’t take much time since the input parameters of the main endpoint remain the same, and each model includes detailed code examples.

This service uses per-second billing. The cost of audio transcription is based on the number of seconds in the input audio file, not the processing time.

post

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Body

application/json

or

or

or

or

or

Responses

201Success

application/json

post

/v1/stt

HTTPcURLJavaScriptPython

POST /v1/stt HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 621

{
  "model": "#g1_nova-2-general",
  "custom_intent": "text",
  "custom_topic": "text",
  "custom_intent_mode": "strict",
  "custom_topic_mode": "strict",
  "detect_language": true,
  "detect_entities": true,
  "detect_topics": true,
  "diarize": true,
  "dictation": true,
  "diarize_version": "text",
  "extra": "text",
  "filler_words": true,
  "intents": true,
  "keywords": "text",
  "language": "text",
  "measurements": true,
  "multi_channel": true,
  "numerals": true,
  "paragraphs": true,
  "profanity_filter": true,
  "punctuate": true,
  "search": "text",
  "sentiment": true,
  "smart_format": true,
  "summarize": "text",
  "tag": [
    "text"
  ],
  "topics": true,
  "utterances": true,
  "utt_split": 1,
  "url": "https://example.com"
}

201Success

{
  "metadata": {
    "transaction_key": "text",
    "request_id": "text",
    "sha256": "text",
    "created": "2026-01-22T13:46:50.246Z",
    "duration": 1,
    "channels": 1,
    "models": [
      "text"
    ],
    "model_info": {
      "ANY_ADDITIONAL_PROPERTY": {
        "name": "text",
        "version": "text",
        "arch": "text"
      }
    }
  },
  "results": {
    "channels": {
      "alternatives": [
        {
          "transcript": "text",
          "confidence": 1,
          "words": [
            {
              "word": "text",
              "start": 1,
              "end": 1,
              "confidence": 1,
              "punctuated_word": "text"
            }
          ],
          "paragraphs": [
            {
              "transcript": "text",
              "paragraphs": {
                "sentences": [
                  {
                    "text": "text",
                    "start": 1,
                    "end": 1
                  }
                ],
                "num_words": 1,
                "start": 1,
                "end": 1
              }
            }
          ]
        }
      ]
    }
  }
}