English Speech-to-Text

Turns a recording of English speech into text, one timestamped segment per speaker turn. Two tiers take the same request and return the same response: Base at 1 IC per minute for recordings up to 10 hours; Pro at 2 IC per minute, the more accurate model, for recordings up to 1 hour.

POST/v3/store/speech/speech-to-text/base/en

+1 endpoints

Try it

Price1 ICper 60 seconds
Served38.2Kcalls

v1.0
Active

Input

OutputPOST /v3/store/speech/speech-to-text/base/en

output: 2 × text: Transcribed text from segment one. start: 0 end: 5.28 speaker: SPEAKER_00 segment: 0
audio_duration_in_seconds: 60.5
uploaded_file_name: example.mp3
processing_time_in_seconds: 12.34
use_asr_pro: false
asr_pro_is_used: false
iapp: seconds: 60.5

Every field, under ResponseOther endpoints: /en see Request

Request

curl -X POST https://api.iapp.co.th/v3/store/speech/speech-to-text/base/en \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@recording.wav"

Response

200OK. The fields are explained under Response.

{
    "output": [
        {
            "text": "Transcribed text from segment one.",
            "start": 0.0,
            "end": 5.28,
            "speaker": "SPEAKER_00",
            "segment": 0
        },
        {
            "text": "Transcribed text from segment two.",
            "start": 5.28,
            "end": 10.56,
            "speaker": "SPEAKER_01",
            "segment": 1
        }
    ],
    "audio_duration_in_seconds": 60.5,
    "uploaded_file_name": "example.mp3",
    "processing_time_in_seconds": 12.34,
    "use_asr_pro": false,
    "asr_pro_is_used": false,
    "iapp": {
        "seconds": 60.5
    }
}

Request

multipart/form-data, one recording per request, to the endpoint of the tier you want.

Tier	Endpoint	Price	Longest recording
Base	`POST /v3/store/speech/speech-to-text/base/en`	1 IC per 60 seconds	10 hours
Pro	`POST /v3/store/speech/speech-to-text/pro/en`	2 IC per 60 seconds	1 hour

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

filefilerequired

The recording. MP3, WAV, M4A, AAC, AIF, CDA, FLAC, MID, OGG or WMA.

promptstring

The prompt template. Default base.

chunk_sizeinteger

Seconds of audio per processing chunk. Default 20.

The legacy paths /asr/v3/en and /asr/v3/en/pro answer at the same prices.

Response

outputarray

The segments, in the order spoken

audio_duration_in_secondsprocessing_time_in_secondsuploaded_file_name

The recording's length, the time taken, the file name

iappobject

Billing

use_asr_proasr_pro_is_used

Whether the Pro model was asked for, and whether it was used

Status codes

Code	Meaning
400	No file, or an unsupported format
404	Task not found
500	Processing failed

English Speech-to-Text

Request

Headers

Body

Response

Details

Measured

Limits

Data handling

Request​

Response​

Details​

Request

Response

Details