Transcribe a recording with the Maybloc API

export BASE=https://app.maybloc.com/api/v1
export API_KEY=mbk_live_...

# 1. Create an upload. The response has id, upload_url and headers.
curl -s $BASE/uploads \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"file_name":"call.m4a","content_type":"audio/mp4","byte_size":4812001}'

# 2. Send the file to upload_url (valid 15 minutes), then mark it complete.
curl -X PUT "$UPLOAD_URL" -H "Content-Type: audio/mp4" --data-binary @call.m4a
curl -s -X POST $BASE/uploads/$UPLOAD_ID/complete -H "Authorization: Bearer $API_KEY"

# 3. Start the transcript. duration_ms is the recording's length.
curl -s $BASE/transcripts \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"upload_id":"'$UPLOAD_ID'","duration_ms":155000}'

# 4. When status is "completed", read the result.
curl -s $BASE/transcripts/$TRANSCRIPT_ID/result -H "Authorization: Bearer $API_KEY"

import { readFile } from "node:fs/promises";
import { randomUUID } from "node:crypto";

const BASE = "https://app.maybloc.com/api/v1";
const json = { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" };
const api = async (path, init = {}) => {
  const response = await fetch(BASE + path, { ...init, headers: { ...json, ...init.headers } });
  if (!response.ok) throw new Error(path + " failed: " + (await response.text()));
  return response.status === 204 ? null : response.json();
};

const bytes = await readFile("call.m4a");
const durationMs = 155000; // the recording's length in milliseconds

// 1 and 2. Create the upload, send the file, mark it complete.
const upload = await api("/uploads", {
  method: "POST",
  body: JSON.stringify({ file_name: "call.m4a", content_type: "audio/mp4", byte_size: bytes.length }),
});
await fetch(upload.upload_url, { method: "PUT", headers: upload.headers, body: bytes });
await api("/uploads/" + upload.id + "/complete", { method: "POST" });

// 3. Start the transcript.
let transcript = await api("/transcripts", {
  method: "POST",
  headers: { "Idempotency-Key": randomUUID() },
  body: JSON.stringify({ upload_id: upload.id, duration_ms: durationMs }),
});

// 4. Poll until it finishes, then read the result.
while (["queued", "processing"].includes(transcript.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  transcript = await api("/transcripts/" + transcript.id);
}
if (transcript.status !== "completed") throw new Error("Transcript " + transcript.status);
const result = await api("/transcripts/" + transcript.id + "/result");
for (const turn of result.turns) console.log(turn.speaker_id, turn.start_ms, turn.text);

import os, time, uuid, requests

BASE = "https://app.maybloc.com/api/v1"
session = requests.Session()
session.headers["Authorization"] = "Bearer " + os.environ["API_KEY"]

def api(method, path, **kwargs):
    response = session.request(method, BASE + path, **kwargs)
    response.raise_for_status()
    return response.json() if response.content else None

with open("call.m4a", "rb") as handle:
    data = handle.read()
duration_ms = 155000  # the recording's length in milliseconds

# 1 and 2. Create the upload, send the file, mark it complete.
upload = api("POST", "/uploads", json={"file_name": "call.m4a", "content_type": "audio/mp4", "byte_size": len(data)})
requests.put(upload["upload_url"], headers=upload["headers"], data=data).raise_for_status()
api("POST", "/uploads/" + upload["id"] + "/complete")

# 3. Start the transcript.
transcript = api("POST", "/transcripts", headers={"Idempotency-Key": str(uuid.uuid4())},
                 json={"upload_id": upload["id"], "duration_ms": duration_ms})

# 4. Poll until it finishes, then read the result.
while transcript["status"] in ("queued", "processing"):
    time.sleep(3)
    transcript = api("GET", "/transcripts/" + transcript["id"])
if transcript["status"] != "completed":
    raise RuntimeError("Transcript " + transcript["status"])
result = api("GET", "/transcripts/" + transcript["id"] + "/result")
for turn in result["turns"]:
    print(turn["speaker_id"], turn["start_ms"], turn["text"])