API pública

Documentación para desarrolladores y ejemplos de solicitudes.

URL base

Use la URL base para todas las solicitudes API.

https://polyglotvoice.ru/api/v1

Autorización

Todas las solicitudes requieren una clave API en el encabezado Authorization.

Authorization: Bearer sk_...

La clave es válida por 30 días y solo funciona para transcriptions/*.

Cómo obtener una clave API

Inicie sesión en su cuenta.
Abra Perfil → «Claves API».
Cree una clave y guárdela (se muestra una sola vez).
Use la clave en sus solicitudes.

Puntos de acceso

Endpoints principales para transcripciones.

POST /api/v1/transcriptions/upload

Subir un archivo para transcribir.

POST /api/v1/transcriptions/from-url

Transcribir desde una URL de medios.

POST /api/v1/transcriptions/validate-url

Validar una URL de medios antes de procesar.

GET /api/v1/transcriptions

Listar tareas de transcripción.

GET /api/v1/transcriptions/{task_id}

Detalles de la tarea.

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

Resultado de la transcripción.

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

Descargar archivo de resultado (srt/txt/json, etc.).

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

Transmitir el medio fuente (Range).

POST /api/v1/transcriptions/convert-audio

Convertir audio y descargar el resultado.

Ejemplos de solicitudes

Ejemplos básicos para empezar.

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);

Formatos de archivo

Se admiten formatos de audio y video populares.

Por ejemplo: mp3, wav, m4a, ogg, mp4, webm.

Respuestas y errores

Ejemplo de creación de tarea y error de auth.

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

{ "detail": "Invalid token." }

Límites

Estos valores los aplica la API. Los límites breves (burst) son por usuario con sesión: la misma cuenta con JWT o con cualquier clave sk_. Los contadores diarios y mensuales cuentan cada solicitud con cualquiera de sus claves sk_ (día y mes civil en UTC). Si se supera el límite, la API responde HTTP 429.

El JSON actual del campo rate_limits lo devuelve:

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

Cargando límites…

Además, cada plan limita la duración máxima de audio por archivo, el tamaño de subida, las tareas en paralelo y (en la web) las subidas diarias: véalo en su cuenta.