Scribe v2

Speech-to-text for transcripts, subtitles, diarization, and audio analysis.

Text

Scribe technical docs

Endpoint, auth header, parameters, prices, and tested request examples for Scribe v2.

Endpoint

Endpoint and pricing

POST /audio/transcriptions Endpoint https://api.imole.app/v1 Base URL 200 API cauris 200 Agent cauris
Headers

Request headers

Authorization required

Bearer Imole API key.

Content-Type required

Use application/json for URL/base64 requests or multipart/form-data for file uploads.

Parameters

Request parameters

model required

Use scribe_v2.

file required

Audio or video file to transcribe.

audio_url

Remote audio URL.

audio_base64

Base64 audio.

language_code

Optional locale hint.

diarize

Speaker diarization.

true, false
tag_audio_events

Label non-speech events.

true, false
timestamps_granularity

Timestamp detail.

none, word, character
keyterms

Vocabulary bias terms.

Examples

Tested request examples

Upload file
curl -X POST "https://api.imole.app/v1/audio/transcriptions" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -F "model=scribe_v2" \
  -F "file=@reference.mp3" \
  -F "language_code=fr" \
Remote audio URL
curl -X POST "https://api.imole.app/v1/audio/transcriptions" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "scribe_v2",
  "audio_url": "https://imole.app/docs-samples/reference.mp3",
  "language_code": "fr",
  "diarize": false,
  "keyterms": [
    "Imole",
    "API"
  ]
}'
Remote audio with word timestamps
curl -X POST "https://api.imole.app/v1/audio/transcriptions" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "scribe_v2",
  "audio_url": "https://imole.app/docs-samples/reference.mp3",
  "language_code": "fr",
  "timestamps_granularity": "word",
  "tag_audio_events": true
}'