Transcripts

GET  /v1/transcripts/{video_id}          # read (teaser until unlocked)
POST /v1/transcriptions                  # submit a video for transcription
GET  /v1/transcriptions/{id}             # poll status (Retry-After)
POST /v1/videos/{video_id}/corrections   # submit corrections (free)

​

Pricing

• 125 rows per 15-minute block of video, rounded up, minimum one block.
• A 62-minute podcast is 5 blocks = 625 rows. A 9-minute clip is 1 block = 125 rows.
• Same price either way: whether a premium transcript already exists in the index or Arcmira generates it fresh for you.
• Unlocks are permanent and per-account. You pay once per video; every subsequent read is free — and if you unlocked a video before its premium transcript existed, running the premium analysis later costs nothing extra.
• If a transcription job fails permanently, the rows are refunded automatically and the unlock is revoked.

{ "quarters": 5, "rows": 625 }

​

Reading a transcript

curl 'https://api.arcmira.com/v1/transcripts/dQw4w9WgXcQ' \
  -H "Authorization: Bearer $ARCMIRA_API_KEY"

​

Unlocking

curl 'https://api.arcmira.com/v1/transcripts/dQw4w9WgXcQ?unlock=true' \
  -H "Authorization: Bearer $ARCMIRA_API_KEY"

• 402 — not enough rows remaining this period (the body includes the quote).
• 403 — transcript access requires a paid plan.

​

Response shape

{
  "video": { "videoId": "…", "title": "…", "channelName": "…", "durationSeconds": 3720 },
  "access": "unlocked",
  "segments": [
    { "index": 0, "start": 0.4, "end": 6.1, "text": "Welcome back to the show…", "speaker": 0 }
  ],
  "speakers": [
    { "id": 0, "label": "Speaker 0", "entity": { "id": 147403, "name": "Emad Mostaque", "slug": "emad-mostaque" } }
  ],
  "annotations": [
    { "segment_index": 12, "char_start": 34, "char_end": 40, "entity_id": 120034, "entity_type": "organization", "name": "OpenAI", "slug": "openai" }
  ],
  "meta": { "diarized": true, "locked": false, "revision": "rwmksmk", "quote": { "quarters": 5, "rows": 625 } }
}

• segments — transcript lines with start/end seconds and a diarization speaker id.
• speakers — the diarization map; entries gain an entity once a speaker has been identified as a person.
• annotations — entity mentions as character spans inside segment text.
• meta.revision — an opaque id for the served transcript plus its approved-correction state. Save it: corrections echo it back, and a changed revision means the transcript changed underneath you.

​

Submitting a video for transcription

curl -X POST 'https://api.arcmira.com/v1/transcriptions' \
  -H "Authorization: Bearer $ARCMIRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }'

{
  "request": {
    "id": "0b0e8f3a-…",
    "videoId": "dQw4w9WgXcQ",
    "status": "queued",
    "stage": "queued",
    "quote": { "quarters": 5, "rows": 625 },
    "etaSeconds": 678,
    "nextPollSeconds": 30
  }
}

• Premium transcript already exists? The request short-circuits to complete and the unlock still applies — unified pricing, no duplicate work. A video with only a preliminary analysis does not short-circuit: you’re buying the premium generation, so the pipeline runs.
• Already unlocked? You are not charged again (quote.rows in the response shows what was actually debited) — including unlocks purchased before the premium transcript existed.
• Already in flight? A second submit for the same video returns the existing request with existing: true.
• Idempotency-Key is supported, per the standard idempotency contract.
• User requests ride a reserved fast lane through the pipeline — submission latency doesn’t degrade when background indexing is busy.

​

Polling

while True:
    res = get(f"/v1/transcriptions/{request_id}")
    if res.json()["status"] in ("complete", "failed", "refunded"):
        break
    time.sleep(int(res.headers.get("Retry-After", "30")))

​

Corrections

​

Lifecycle

1. Submit — the correction lands as a pending row, attributed to your key. Speaker identifications additionally create a community-flagged appearance on the person’s page right away.
2. Pending — visible to you in the transcript GET (edits[], speakerIdentifications[], …); withdrawable via the matching DELETE.
3. Approved — applied for everyone at read time; meta.revision changes.
4. Rejected / reverted — removed from view; reverting a speaker identification also deletes the appearance it created.

​

Unified endpoint

curl -X POST 'https://api.arcmira.com/v1/videos/dQw4w9WgXcQ/corrections' \
  -H "Authorization: Bearer $ARCMIRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "kind": "line_edit",
    "revision": "rwmksmk",
    "anchor": { "segmentIndex": 12, "contentHash": "1a2b3c" },
    "payload": {
      "segmentIndex": 12,
      "originalText": "Anthropics new cloud 4.5",
      "correctedText": "Anthropic'\''s new Claude 4.5"
    }
  }'

​

Anchors, revisions, and ordering

• revision — echo meta.revision from the transcript GET.
• anchor.contentHash — a djb2 hash of the covered segment text (segments joined with \n for multi-segment selections), base-36 encoded:

function djb2(input) {
  let hash = 5381;
  for (let i = 0; i < input.length; i++) {
    hash = ((hash << 5) + hash + input.charCodeAt(i)) >>> 0;
  }
  return hash.toString(36);
}

• seq (optional) — a per-video monotonic counter for clients that submit streams of dependent corrections (sub-line splits re-index later segments, so order matters). One-off submissions can omit it.

​

Purpose-built wrappers

POST   /v1/transcripts/{video_id}/edits          { segmentIndex, originalText, correctedText }
DELETE /v1/transcripts/{video_id}/edits/{id}

POST   /v1/transcripts/{video_id}/speakers       { speakerId, entityId }  or  { speakerId, name }
DELETE /v1/transcripts/{video_id}/speakers/{id}

POST   /v1/transcripts/{video_id}/merges         { sourceName, targetEntityId, replaceWith? }
GET    /v1/transcripts/{video_id}/merges
DELETE /v1/transcripts/{video_id}/merges/{id}

• Edits fix segment text.
• Speakers identify who a diarized voice is — this creates the community appearance immediately; withdrawing removes it.
• Merges fix misattributed name mentions within one video (“mentions of Imad in this video are Emad Mostaque”), optionally respelling the transcript text. Mentions of the same name in other videos are untouched.

DELETE /v1/corrections/speaker-edits/{id}
DELETE /v1/corrections/entity-tags/{id}