Skip to content

Transcribe

POSThttps://api.curriculo.me/public/transcribe/
On this page

Stateless. Transcribes one audio or video recording, without generating a summary. To get a summary as well, use POST /summary/.

Price: $0.002 per minute of audio. See Pricing and billing.

Request

multipart/form-data

FieldTypeNotes
media (required)fileOne audio or video recording, up to 12 MB.
languagestringOptional ISO 639-1 hint for the recording's language.
curl -X POST https://api.curriculo.me/public/transcribe/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F '[email protected]' \
  -F 'language=en'

Longer recordings

The synchronous upload is limited to 12 MB. For anything larger, send a public link to POST /transcribe/async: recordings up to 1 GB and 2 hours.

curl -X POST https://api.curriculo.me/public/transcribe/async \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"media_url": "https://example.com/interviews/interview.mp4"}'

The task's result contains transcript_text and transcript_entries. Entries are empty when no timestamps are available. See Background processing and callbacks.

Errors

StatusTypical cause
413A recording over 12 MB. Use /transcribe/async.
422media is missing.
503Media transcription is not enabled.
504Processing exceeded 300 seconds. Use /transcribe/async.

Updated