Sondear y leer el resultado

queued ──▶ processing ──▶ completed
                      └─▶ failed

{
  "id": "tr_MoKLFufBqnzJ",
  "status": "processing",
  "created_at": "2026-07-29T08:13:02.114Z",
  "completed_at": null,
  "metadata": { "ticket": "T-91823" },
  "error": null
}

import time, httpx

FINALES = {"completed", "failed", "cancelled"}

def esperar(cliente, ids, intervalo=10.0, limite_s=3600.0):
    pendientes, hechos = set(ids), {}
    limite = time.monotonic() + limite_s

    while pendientes and time.monotonic() < limite:
        time.sleep(intervalo)
        restantes = None

        for tid in list(pendientes):
            r = cliente.get(f"{BASE}/transcripts/{tid}")

            if r.status_code == 429:
                time.sleep(int(r.headers.get("retry-after", 30)))
                break

            r.raise_for_status()
            restantes = int(r.headers.get("x-ratelimit-remaining", 300))

            cuerpo = r.json()
            if cuerpo["status"] in FINALES:
                hechos[tid] = cuerpo
                pendientes.discard(tid)

        # Frenar antes de chocar. `X-RateLimit-Reset` vale 0 mientras la petición se
        # permite, así que usarlo aquí sería dormir cero segundos.
        if restantes is not None and restantes < 50:
            time.sleep(15)

    for tid in pendientes:
        hechos[tid] = {"id": tid, "status": "timeout"}
    return hechos

{
  "id": "tr_MoKLFufBqnzJ",
  "status": "completed",
  "metadata": { "ticket": "T-91823" },

  "language": "es",
  "language_confidence": 0.95,

  // Duraciones, en SEGUNDOS
  "audio_duration": 216.999,     // lo que dura el audio que enviaste
  "billed_duration": 240,        // minutos empezados × 60 — es lo que se factura
  "speech_duration": 96.538,     // habla real tras quitar silencios

  "text": "Acme Telecom, buenos días, le atiende Marta…",
  "words": [{ "text": "Acme", "start": 0, "end": 0.62, "method": "approx" }],

  "utterances": [
    {
      "speaker": "1",
      "speakerRole": "agent",       // ⚠ camelCase, a diferencia del resto del JSON
      "text": "Acme Telecom, buenos días…",
      "start": 0,
      "end": 5.2
    }
  ],

  "speaker_role_confidence": 0.9,
  "understanding": { /* … */ },
  "pii": null,
  "metrics": { /* … */ },
  "warnings": [],
  "usage": { "total_eur": 0.041 }
}

const t = respuesta;
const w = t.warnings ?? [];

// 1. ¿Son fiables los roles agente/cliente?
const rolesFiables =
  !w.some(x => ['attribution_heuristic_disagrees',
                'diarization_single_speaker',
                'diarization_unavailable'].includes(x)) &&
  (t.speaker_role_confidence ?? 0) >= 0.6;

// 2. Con redacción activa, el texto tapado NO es `text`.
const texto  = t.pii ? t.pii.text_redacted       : t.text;
const turnos = t.pii ? t.pii.utterances_redacted : t.utterances;

// 3. `understanding` es {} cuando no se pidió nada: comprueba claves, no el objeto.
const resumen = t.understanding?.summarization?.text ?? null;