TranscritorAi-API
Alle API-Endpunkte, was sie tun und ob eine Anmeldung nötig ist. Dieselben Daten stehen auch in den automatischen Formaten unten zur Verfügung.
Die Basis-URL ist die Adresse dieser Website selbst (gleicher Ursprung, es gibt keine separate API-Domain).
Endpoints mit "Login erforderlich" erwarten den Header Authorization: Bearer
Konten mit Bestätigung in zwei Schritten: POST /api/auth/login antwortet mit requer_2fa: true und einem desafio (Challenge); sende die Challenge und den 6-stelligen Code an POST /api/auth/login/2fa, um das Token zu erhalten. Auf der Website liegt die Sitzung in einem HttpOnly-Cookie; die API für Skripte nutzt weiterhin Authorization: Bearer.
Contabilização: cada arquivo ou link custa 1 crédito, descontado no envio (primeiro da cota mensal do plano, depois do saldo avulso). Vídeo custa 1 crédito a cada 5 min, áudio a cada 10 min e PDF/DOCX/TXT a cada 100 páginas. Falhas e cancelamentos devolvem os créditos; "pular" um arquivo já processado e reprocessar uma falha não cobram. Consulte GET /api/usuarios/eu/capacidade antes de enviar.
API für Entwickler (v1)
Nutzen Sie einen API-Schlüssel, um aus Ihrem eigenen System zu transkribieren. Erstellen Sie den Schlüssel unter Mein Konto auf dem Tab Optionen. Die Aufrufe verbrauchen das Credit-Kontingent des API-Tarifs des Kontos und das Ergebnis erscheint auch unter Meine Dateien.
Senden Sie den Schlüssel in Authorization: Bearer tr_live_.... Er gilt nur für /api/v1: Die Anmeldung der Website gilt dort nicht und der Schlüssel gilt nicht für die übrigen API-Routen.
Die Verarbeitung ist asynchron: Das Erstellen antwortet sofort mit der id und status: queued. Fragen Sie den Fortschritt mit GET ab oder erhalten Sie am Ende einen Webhook. Der Text steht in result.text.
Beispiel: eine Transkription erstellen
curl -X POST https://transcritorai.com/api/v1/transcriptions \
-H "Authorization: Bearer tr_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"source": {"type": "url", "url": "https://exemplo.com/reuniao.mp4"}, "metadata": {"id": "123"}}'
# 202 Accepted
{"id": "...", "status": "queued", "metadata": {"id": "123"}, ...}
curl https://transcritorai.com/api/v1/transcriptions/ID -H "Authorization: Bearer tr_live_SUA_CHAVE"
# {"status": "completed", "result": {"text": "..."}, ...}
Jede Webhook-Benachrichtigung enthält den Header X-Transcritor-Signature: t=...,v1=..., den HMAC-SHA256 von t.Body mit Ihrem Geheimnis (whsec_..., auf dem Tab Optionen unter Mein Konto). Prüfen Sie die Signatur und lehnen Sie Benachrichtigungen mit altem t ab. Nur öffentliche https-Adressen. Antwortet Ihr System nicht mit 2xx, versuchen wir es bis zu 4 Mal; danach fragen Sie mit GET ab.
Die Signatur eines Webhooks prüfen
import hashlib, hmac, time
def aviso_valido(segredo, cabecalho, corpo_bytes):
partes = dict(p.split("=", 1) for p in cabecalho.split(","))
esperado = hmac.new(segredo.encode(), partes["t"].encode() + b"." + corpo_bytes, hashlib.sha256).hexdigest()
recente = abs(time.time() - int(partes["t"])) < 300
return recente and hmac.compare_digest(esperado, partes["v1"])
Das Limit pro Minute hängt vom Tarif ab und gilt pro Schlüssel (Antwort 429 mit Retry-After). Credit-Kontingent aufgebraucht: Antwort 402 cota_esgotada. Eine Übermittlung gleichzeitig pro Konto: Bei 409 envio_em_andamento versuchen Sie es in ein paar Sekunden erneut.
API-Tarife
Die API hat ein eigenes Kontingent, getrennt von dem der Website. Die Credits sind dieselben wie auf der Website (1 Credit pro Datei oder je 5 Minuten Video) und werden jeden Monat zurückgesetzt. Das Limit pro Minute gilt pro Schlüssel. Glossare in der API gibt es ab Startup.
Startup und Business buchen Sie per Karte über Mercado Pago unter Pläne (Tab API), monatlich oder jährlich (der Jahrestarif kostet 10 Monatsraten). Der Tarif gilt erst nach genehmigter Zahlung und verlängert sich automatisch über die gespeicherte Karte; wird die Verlängerung länger als 3 Tage abgelehnt, fällt das Konto auf Developer zurück. Sie können jederzeit auf demselben Bildschirm kündigen. Startup ist auch in der Komplett-Kombi + API enthalten. Enterprise gibt es auf Anfrage: Wenden Sie sich an den Support.
Routen
POST /api/v1/transcriptions·POST /api/v1/transcriptions/upload: Erstellt eine Transkription aus einer Adresse (JSON) oder einer Datei (multipart). Akzeptiert glossary_id, webhook_url und metadata.GET /api/v1/transcriptions/{id}: Status (queued, processing, completed, failed, canceled) und, wenn fertig, der Text in result.text.GET /api/v1/transcriptions: Seitenweise Liste der per API erstellten Transkriptionen, ohne den Text.DELETE /api/v1/transcriptions/{id}: Läuft sie noch, wird sie abgebrochen; danach aus der Liste entfernt. Der Text bleibt unter Meine Dateien.GET /api/v1/usage: Tarif, Monatslimit, verbraucht, verbleibend, zusätzliche Credits und das Limit pro Minute.POST|GET /api/v1/webhooks·DELETE /api/v1/webhooks/{id}·GET /api/v1/webhooks/deliveries: Registriert Benachrichtigungsadressen (https) und zeigt den Zustellverlauf.GET|POST /api/v1/glossaries·GET|POST /api/v1/glossaries/{id}/terms: Glossare und Begriffe im Stapel (bis zu 500 pro Aufruf), damit Namen und Fachbegriffe stimmen.POST|GET /api/v1/transcriptions/{id}/studio: Studio-Modus über die API: erstellt die YouTube-Kapitel (chapters), die Show Notes (show_notes) oder die Hooks (hooks) einer Transkription, mit dem eigenen KI-Schlüssel des Kontos. Verbraucht 5 API-Credits pro Kit (die anderen Produkte derselben Folge im Monat kosten nichts mehr) und meldet über Webhooks (studio.completed und studio.failed). GET liefert das fertige Kit.