Introduction to Andebet API

# 1. Export your development key
export ANDEBET_API_KEY="and_dev_YOUR_KEY_HERE"
# 2. Submit audio for transcription
curl -X POST https://api.andebet.ai/v1/transcriptions \
  -H "Authorization: Bearer $ANDEBET_API_KEY" \
  -F "[email protected]" \
  -F "language=auto" \
  -F "diarization=true" \
  -F "evidence_timestamps=true"

# Valid authorization header
Authorization: Bearer and_live_7f4c9a8102bd482ae019

{
  "id": "job_01J8YV9X2KM04",
  "object": "transcription",
  "status": "completed",
  "language": "om",
  "duration_seconds": 15.07,
  "usage": {
    "audio_seconds": 15.07,
    "billed_units": 1
  },
  "text": "Daangiti tokko hanga waggaa tokkoofi ji'a sadii dokumantiin isaachuma keessa jira...",
  "subtitles": {
    "srt": "1\n00:00:00,000 --> 00:00:05,800\n[Speaker 1] Daangiti tokko hanga waggaa tokkoofi ji'a sadii dokumantiin isaachuma keessa jira.\n",
    "vtt": "WEBVTT - Generated by Andebet AI Speech Intelligence\n\n1\n00:00:00.000 --> 00:00:05.800\n<v Speaker 1>Daangiti tokko hanga waggaa tokkoofi ji'a sadii dokumantiin isaachuma keessa jira.\n"
  },
  "evidence_markers": [
    {
      "id": "ev_1",
      "startTime": 0.0,
      "label": "Document Retention Timeline",
      "quote": "Daangiti tokko hanga waggaa tokkoofi ji'a sadii...",
      "confidence": 0.98
    }
  ],
  "segments": [
    {
      "id": "seg_001",
      "speaker": "Speaker 1",
      "start": 0.0,
      "end": 5.8,
      "text": "Daangiti tokko hanga waggaa tokkoofi ji'a sadii dokumantiin isaachuma keessa jira.",
      "translation": "The document remains active within the system for up to one year and three months.",
      "confidence": 0.96
    }
  ]
}

# Status Polling via GET
curl -X GET https://api.andebet.ai/v1/transcriptions/tra_01J9KW2X89LM02 \
  -H "Authorization: Bearer $ANDEBET_API_KEY"

{
  "error": {
    "code": "unsupported_audio_format",
    "message": "Expected audio MIME type. Received application/pdf.",
    "param": "file",
    "request_id": "req_01J8YV9ERR02"
  }
}

import { AndebetClient } from '@andebet/sdk';
import fs from 'fs';
const apiKey = process.env.ANDEBET_API_KEY;
if (!apiKey) throw new Error('ANDEBET_API_KEY is required.');
const andebet = new AndebetClient({ apiKey });
const result = await andebet.transcriptions.create({
  file: fs.createReadStream('interview.mp3'),
  language: 'auto',
  diarization: true,
  evidenceTimestamps: true,
});
console.log('ID:', result.id);
console.log('Detected Language:', result.language_detected);

import os
from andebet import Andebet
api_key = os.environ.get("ANDEBET_API_KEY")
if not api_key:
    raise ValueError("ANDEBET_API_KEY is required.")
client = Andebet(api_key=api_key)
with open("interview.mp3", "rb") as f:
    result = client.transcriptions.create(
        file=f,
        language="auto",
        diarization=True,
        evidence_timestamps=True
    )
print(f"ID: {result.id}")

import crypto from 'crypto';
export function verifyWebhookSignature({ rawPayload, signatureHeader, secret, toleranceSeconds = 300 }) {
  if (!signatureHeader || !rawPayload || !secret) return false;
  const parts = signatureHeader.split(',');
  const timestampStr = parts.find(p => p.startsWith('t='))?.slice(2);
  const signatureHex = parts.find(p => p.startsWith('v1='))?.slice(3);
  if (!timestampStr || !signatureHex) return false;
  const timestamp = parseInt(timestampStr, 10);
  if (isNaN(timestamp) || Math.abs(Math.floor(Date.now() / 1000) - timestamp) > toleranceSeconds) {
    return false; // Replay attack detected
  }
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(`${timestamp}.${rawPayload}`);
  const expectedHex = hmac.digest('hex');
  const sigBuf = Buffer.from(signatureHex, 'hex');
  const expBuf = Buffer.from(expectedHex, 'hex');
  return sigBuf.length === expBuf.length && crypto.timingSafeEqual(sigBuf, expBuf);
}