Skip to main content
POST
/
v1
/
echo
/
transcribe
Synchronous audio transcription
curl --request POST \
  --url http://co-mind-platform-host/v1/echo/transcribe \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form audio='@example-file'
{
  "id": "echo_1718200000",
  "object": "echo.transcription",
  "created_at": 1718200000,
  "text": "<string>",
  "segments": [
    {
      "start": 123,
      "end": 123,
      "text": "<string>",
      "speaker": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Supports two token types:

  • JWT Access Token — obtained via POST /v1/auth/login
  • Personal Access Token (PAT) — created via POST /v1/api-tokens, format: cmnd_<tokenId>.<secret>

Query Parameters

​
language
string
default:en

Language code for transcription

​
quality
enum<string>
default:fast

Transcription quality

Available options:
fast,
accurate
​
enable_diarization
boolean
default:true

Enable speaker diarization

​
num_speakers
integer

Expected number of speakers

Body

multipart/form-data
​
audio
file
required

Audio file to transcribe

Response

Transcription result

​
id
string
Example:

"echo_1718200000"

​
object
string
Example:

"echo.transcription"

​
created_at
integer
Example:

1718200000

​
text
string

Full transcription text

​
segments
object[]