Яндекс.Метрика

Öffentliches API

Entwicklerdokumentation und Anfragebeispiele.

Basis-URL

Verwenden Sie die Basis-URL für alle API-Anfragen.

https://polyglotvoice.ru/api/v1

Autorisierung

Alle Anfragen erfordern einen API-Schlüssel im Authorization-Header.

Authorization: Bearer sk_...

Der Schlüssel ist 30 Tage gültig und funktioniert nur für transcriptions/*.

So erhalten Sie einen API-Schlüssel

  1. Melden Sie sich an.
  2. Öffnen Sie Profil → „API-Schlüssel“.
  3. Erstellen Sie einen Schlüssel und speichern Sie ihn (einmalige Anzeige).
  4. Verwenden Sie den Schlüssel in Anfragen.

Endpunkte

Kernendpunkte für Transkriptionen.

POST /api/v1/transcriptions/upload

Datei für die Transkription hochladen.

POST /api/v1/transcriptions/from-url

Transkription per Media-URL.

POST /api/v1/transcriptions/validate-url

Media-URL vor dem Start prüfen.

GET /api/v1/transcriptions

Transkriptionsaufgaben auflisten.

GET /api/v1/transcriptions/{task_id}

Aufgabendetails.

GET /api/v1/transcriptions/{task_id}/result

Transkriptionsergebnis.

GET /api/v1/transcriptions/{task_id}/downloads/{kind}

Ergebnisdatei herunterladen (srt/txt/json etc.).

GET /api/v1/transcriptions/{task_id}/source

Quellmedium streamen (Range).

POST /api/v1/transcriptions/convert-audio

Audio konvertieren und Ergebnis herunterladen.

Anfragebeispiele

Grundlegende Beispiele für den Einstieg.

curl

curl -X POST "https://polyglotvoice.ru/api/v1/transcriptions/upload" \
  -H "Authorization: Bearer sk_..." \
  -F "file=@audio.mp3"

Python

import requests

url = "https://polyglotvoice.ru/api/v1/transcriptions/upload"
headers = {"Authorization": "Bearer sk_..."}
files = {"file": open("audio.mp3", "rb")}

response = requests.post(url, headers=headers, files=files)
print(response.json())

JavaScript

const formData = new FormData();
formData.append("file", file);

fetch("https://polyglotvoice.ru/api/v1/transcriptions/upload", {
  method: "POST",
  headers: { Authorization: "Bearer sk_..." },
  body: formData
})
  .then((res) => res.json())
  .then(console.log);

Dateiformate

Beliebte Audio- und Videoformate werden unterstützt.

Zum Beispiel: mp3, wav, m4a, ogg, mp4, webm.

Antworten und Fehler

Beispiel für Aufgabenerstellung und Auth-Fehler.

{ "task_id": "9b9c1b9a-....", "status": "queued" }
{ "detail": "Invalid token." }

Limits

Die Werte werden von der API durchgesetzt. Kurzfristige (Burst-)Limits gelten pro angemeldetem Nutzer — dasselbe Konto mit Sitzungs-JWT oder sk_-Schlüssel. Tages- und Monatszähler zählen jede Anfrage mit einem Ihrer sk_-Schlüssel (UTC-Kalendertag und -monat). Bei Überschreitung antwortet die API mit HTTP 429.

Das aktuelle JSON-Feld rate_limits liefert:

GET https://polyglotvoice.ru/api/v1/developer/documentation

Limits werden geladen…

Zusätzlich begrenzt jeder Tarif maximale Audiolänge pro Datei, Upload-Größe, parallele Aufgaben und (auf der Website) tägliche Uploads — siehe Ihr Abo im Dashboard.