Документация API

# 1. загрузить файл
curl -H "X-API-Key: $KEY" -F file=@call.wav https://api.yotta.kz/v1/transcriptions

# 2. следить за распознаванием в реальном времени
curl -N "https://api.yotta.kz/v1/transcriptions/$ID/events?token=$STREAM_TOKEN"

# 3. или забрать готовый результат
curl -H "X-API-Key: $KEY" https://api.yotta.kz/v1/transcriptions/$ID

curl -X POST https://api.yotta.kz/v1/upload-tokens \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"ttl_s": 600, "max_duration_s": 300}'

# 201 {"upload_token": "ut.acc_….1794….300.ab12…", "expires_at": 1794509204, "max_duration_s": 300}

curl -H "X-API-Key: $KEY" \
  -F file=@call.wav \
  -F merge=true \
  -F 'metadata={"store":"almaty-12"}' \
  -F webhook_url=https://example.kz/yotta/webhook \
  https://api.yotta.kz/v1/transcriptions

{
  "id": "tr_1a1d…",
  "status": "queued",
  "filename": "call.wav",
  "duration_s": 10.8,
  "billed_s": 11,
  "stream_url": "https://api.yotta.kz/v1/transcriptions/tr_1a1d…/events",
  "stream_token": "1794509204.39dc0e57…"
}

curl -H "X-API-Key: $KEY" \
  -F files=@a.wav -F files=@b.mp3 -F files=@c.ogg \
  https://api.yotta.kz/v1/batches

# 202 {"batch_id": "bt_…",
#      "items": [ {…как для одного файла…}, {"filename": "x.txt", "status": "rejected", "error": "…"} ],
#      "stream_url": "…/v1/batches/bt_…/events", "stream_token": "…"}

const segments = new Map();
const es = new EventSource(`${task.stream_url}?token=${task.stream_token}`);

es.addEventListener("status", (e) => {
  const d = JSON.parse(e.data); // queued(position) | processing | queued + retry
});
es.addEventListener("progress", (e) => {
  const { percent } = JSON.parse(e.data);
});
es.addEventListener("segment", (e) => {
  const { segment } = JSON.parse(e.data);
  segments.set(segment.id, segment);                       // upsert
  render([...segments.values()].sort((a, b) => a.start - b.start));
});
es.addEventListener("done", (e) => {
  const result = JSON.parse(e.data);
  es.close();
});
es.addEventListener("error", (e) => {
  if (e.data) {                     // ошибка задачи, а не обрыв сети
    const err = JSON.parse(e.data);
    es.close();
  }
});

curl -H "X-API-Key: $KEY" https://api.yotta.kz/v1/transcriptions/$ID

POST <webhook_url>
X-Yotta-Timestamp: 1794509204
X-Yotta-Signature: sha256=<HMAC-SHA256(webhook_secret, timestamp + "." + body)>
Content-Type: application/json

{"event": "transcription.done" | "transcription.failed", "data": { …результат как в GET… }}

import crypto from "node:crypto";

// Next.js route handler: app/api/yotta/webhook/route.ts
export async function POST(req: Request) {
  const raw = await req.text();
  const ts = req.headers.get("x-yotta-timestamp") ?? "";
  const sig = req.headers.get("x-yotta-signature") ?? "";

  const expected = "sha256=" + crypto
    .createHmac("sha256", process.env.YOTTA_WEBHOOK_SECRET!)
    .update(`${ts}.${raw}`)
    .digest("hex");

  const ok = sig.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig));
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  if (!ok || !fresh) return new Response("bad signature", { status: 401 });

  const { event, data } = JSON.parse(raw);
  // event: "transcription.done" | "transcription.failed"
  return new Response("ok");
}

{
  "id": "tr_1a1d0e9d5ee6fe6fbd2",
  "status": "done",
  "batch_id": null,
  "filename": "t3_001.wav",
  "created_at": "2026-11-12T17:59:08.498143+00:00",
  "finished_at": "2026-11-12T17:59:58.101+00:00",
  "duration_s": 39.99,
  "billed_s": 40,
  "params": {"language": "auto", "diarization": false, "merge": true},
  "metadata": {"store": "almaty-12"},
  "text": "нормально, еле-еле мне нужны которые …",
  "speech_s": 31.85,
  "languages": ["kk", "ru"],
  "speakers": [],
  "segments": [
    {
      "id": 1, "start": 1.91, "end": 3.27,
      "text": "мне нужны которые",
      "language": "ru", "language_confidence": 1.0,
      "confidence": 0.812,
      "speaker": null, "speaker_confidence": null,
      "merged": true,
      "words": [
        {"w": "мне", "start": 1.99, "end": 2.11, "conf": 0.888},
        {"w": "которые", "start": 2.63, "end": 2.95, "conf": 0.7, "edited": true}
      ]
    }
  ],
  "model": {"asr": "gigaam-ml+k5", "merge": "…", "worker_version": "0.1.0"},
  "timings": {"vad_s": 0.3, "asr_s": 11.6, "total_s": 12.8, "rtf": 0.32}
}

curl -H "X-API-Key: $KEY" -o call.srt "https://api.yotta.kz/v1/transcriptions/$ID/export?format=srt"

1
00:00:01,910 --> 00:00:03,270
мне нужны которые

curl -H "X-API-Key: $KEY" https://api.yotta.kz/v1/balance