Transcription

A timed transcript of an audio or video recording, with captions files.

Price1 credit (10p) per started 10 minutes
Typical time30 s to 15 min
Scopemedia:write
Runs asA background job

Try it

Run transcription in the sandbox

No key and nothing to pay. The sandbox returns a realistic example in a couple of seconds; no AI runs and no data is kept.

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Upload the recording with POST /v1/files (up to 500 MiB) and send its file_id. The transcript keeps the speaker's own language and hesitations; each segment and word has start and end times in milliseconds (word_timing says whether word times come from the provider or are estimated within measured speech). Saves transcript.vtt, transcript.srt and transcript.txt. Recordings can be up to 3 hours. Charged per started 10 minutes of the measured recording; declare duration_seconds to reserve only what you need.

Requires media:write. Costs 1 credit per started 10 minutes. Send a unique Idempotency-Key; reuse it with the identical body when retrying. Returns 202 with a job: poll GET /jobs/{job_id}, stream GET /jobs/{job_id}/events, or use a signed webhook.

Transcription

POST/v1/transcriptions

Scope media:write

Headers

Transcription: headers
Field	Details
`Idempotency-Key`	stringRequiredA unique key per new operation; reuse it with the identical body when retrying.
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Request body

Transcription: request body
Field	Details
`file`	FileReferenceRequiredAn audio or video recording uploaded with POST /v1/files (MP4, MOV, WEBM, M4A, MP3, WAV or OGG, up to 500 MiB).
`file_id`file.file_id	stringRequiredThe id returned by POST /v1/files, after POST /v1/files/{id}/complete reported ready.Pattern `^file_[a-f0-9]{32}$`
`duration_seconds`	integer, optionalThe recording's length, if you know it. EduMark reserves credits for this length and charges for the measured length; without it the 3-hour maximum is reserved.1 to 10,800

Responses

Status	Meaning
202	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
402	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Request

curl -X POST 'https://api.edumark.ai/v1/transcriptions' \
  -H "Authorization: Bearer $EDUMARK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "file": {
    "file_id": "file_3f2a9c0b5d7e4a1b8c6d2e0f9a8b7c6d"
  },
  "duration_seconds": 312
}'

# Then poll until the job finishes (wait poll_after_seconds between calls)
curl 'https://api.edumark.ai/v1/jobs/job_01JB7Q8M4X2V9R' \
  -H "Authorization: Bearer $EDUMARK_API_KEY"

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Response 202JSON

{
  "id": "job_0123456789abcdef0123456789abcdef01234567",
  "product": "transcriptions",
  "status": "queued",
  "poll_after_seconds": 2,
  "credits": 1,
  "result_available": false
}

Finished job: resultJSON

{
  "status": "completed",
  "duration_seconds": 312,
  "billed_blocks": 1,
  "language": "en",
  "word_timing": "provider",
  "truncated": false,
  "text": "Good morning. Today we are looking at how plants make their food.\nPhotosynthesis happens in the leaves, inside the chloroplasts.\nPlants take in carbon dioxide and water, and use light to make glucose.",
  "segments": [
    {
      "id": "seg-1",
      "start_ms": 0,
      "end_ms": 4200,
      "text": "Good morning. Today we are looking at how plants make their food.",
      "words": [
        {
          "text": "Good",
          "start_ms": 0,
          "end_ms": 350
        },
        {
          "text": "morning.",
          "start_ms": 350,
          "end_ms": 700
        },
        {
          "text": "Today",
          "start_ms": 700,
          "end_ms": 1050
        },
        {
          "text": "we",
          "start_ms": 1050,
          "end_ms": 1400
        },
        {
          "text": "are",
          "start_ms": 1400,
          "end_ms": 1750
        },
        {
          "text": "looking",
          "start_ms": 1750,
          "end_ms": 2100
        },
        {
          "text": "at",
          "start_ms": 2100,
          "end_ms": 2450
        },
        {
          "text": "how",
          "start_ms": 2450,
          "end_ms": 2800
        },
        {
          "text": "plants",
          "start_ms": 2800,
          "end_ms": 3150
        },
        {
          "text": "make",
          "start_ms": 3150,
          "end_ms": 3500
        },
        {
          "text": "their",
          "start_ms": 3500,
          "end_ms": 3850
        },
        {
          "text": "food.",
          "start_ms": 3850,
          "end_ms": 4200
        }
      ]
    },
    {
      "id": "seg-2",
      "start_ms": 4600,
      "end_ms": 9800,
      "text": "Photosynthesis happens in the leaves, inside the chloroplasts.",
      "words": [
        {
          "text": "Photosynthesis",
          "start_ms": 4600,
          "end_ms": 5250
        },
        {
          "text": "happens",
          "start_ms": 5250,
          "end_ms": 5900
        },
        {
          "text": "in",
          "start_ms": 5900,
          "end_ms": 6550
        },
        {
          "text": "the",
          "start_ms": 6550,
          "end_ms": 7200
        },
        {
          "text": "leaves,",
          "start_ms": 7200,
          "end_ms": 7850
        },
        {
          "text": "inside",
          "start_ms": 7850,
          "end_ms": 8500
        },
        {
          "text": "the",
          "start_ms": 8500,
          "end_ms": 9150
        },
        {
          "text": "chloroplasts.",
          "start_ms": 9150,
          "end_ms": 9800
        }
      ]
    },
    {
      "id": "seg-3",
      "start_ms": 10300,
      "end_ms": 15900,
      "text": "Plants take in carbon dioxide and water, and use light to make glucose.",
      "words": [
        {
          "text": "Plants",
          "start_ms": 10300,
          "end_ms": 10730
        },
        {
          "text": "take",
          "start_ms": 10730,
          "end_ms": 11160
        },
        {
          "text": "in",
          "start_ms": 11160,
          "end_ms": 11590
        },
        {
          "text": "carbon",
          "start_ms": 11590,
          "end_ms": 12020
        },
        {
          "text": "dioxide",
          "start_ms": 12020,
          "end_ms": 12450
        },
        {
          "text": "and",
          "start_ms": 12450,
          "end_ms": 12880
        },
        {
          "text": "water,",
          "start_ms": 12880,
          "end_ms": 13310
        },
        {
          "text": "and",
          "start_ms": 13310,
          "end_ms": 13740
        },
        {
          "text": "use",
          "start_ms": 13740,
          "end_ms": 14170
        },
        {
          "text": "light",
          "start_ms": 14170,
          "end_ms": 14600
        },
        {
          "text": "to",
          "start_ms": 14600,
          "end_ms": 15030
        },
        {
          "text": "make",
          "start_ms": 15030,
          "end_ms": 15460
        },
        {
          "text": "glucose.",
          "start_ms": 15460,
          "end_ms": 15890
        }
      ]
    }
  ],
  "media": {
    "kind": "audio",
    "has_video": false,
    "has_audio": true,
    "width": null,
    "height": null
  },
  "provenance": {
    "engine": "edumark_media_transcription",
    "ai_generated": true,
    "sandbox": true
  }
}