API de Escribelo — Documentación para Desarrolladores

¿Qué es Escribelo?

Escribelo es una API REST de speech-to-text optimizada para español latinoamericano. Sube un archivo de audio y recibe la transcripción en JSON, SRT, VTT o texto plano.

Soporta: MP3, WAV, M4A, OGG, FLAC, MP4, WebM, AAC, Opus. Hasta 100 MB por archivo.

Tres niveles: fast (rápido), standard (balanceado), accuracy (máxima precisión para audio difícil).

Gratis: 60 min/mes. Pro ($9/mes): 300 min/mes. Scale ($29/mes): 1,800 min/mes. PAYG: $0.005/min.

Autenticación

El tier gratuito no requiere autenticación. Los límites se aplican por IP.

Para planes Pro/Scale/PAYG, envía tu API key:

Authorization: Bearer tu-api-key

Endpoints

Método	Ruta	Descripción
`POST`	/v1/transcribe	Transcribe archivo de audio a texto
`GET`	/pricing	Planes y precios (JSON)
`GET`	/stats	Estadísticas públicas del servicio

Ejemplos de uso

Transcribir un archivo MP3

Sube un MP3 y recibe la transcripción completa en JSON con timestamps.

curl -X POST https://escribelo.4l3.org/v1/transcribe \
  -F "[email protected]" \
  -F "tier=standard" \
  -F "language=es" \
  -F "output=json"

import requests

with open("grabacion.mp3", "rb") as f:
    response = requests.post(
        "https://escribelo.4l3.org/v1/transcribe",
        files={"file": ("grabacion.mp3", f, "audio/mpeg")},
        data={
            "tier": "standard",
            "language": "es",
            "output": "json",
        },
    )

result = response.json()
print(result["text"])

const formData = new FormData();
formData.append("file", audioFile); // File object
formData.append("tier", "standard");
formData.append("language", "es");
formData.append("output", "json");

const response = await fetch("https://escribelo.4l3.org/v1/transcribe", {
  method: "POST",
  body: formData,
});
const { text, segments } = await response.json();
console.log(text);

Respuesta:

{
  "text": "Hola, bienvenidos al podcast de hoy...",
  "language": "es",
  "duration_s": 342.5,
  "segments": [
    {"start": 0.0, "end": 2.4, "text": "Hola, bienvenidos al podcast de hoy."},
    {"start": 2.8, "end": 5.1, "text": "Hoy vamos a hablar de inteligencia artificial."}
  ]
}

Obtener subtítulos SRT

Cambia el parámetro output a 'srt' para recibir subtítulos listos para video.

curl -X POST https://escribelo.4l3.org/v1/transcribe \
  -F "[email protected]" \
  -F "tier=accuracy" \
  -F "language=es" \
  -F "output=srt" \
  --output subtitulos.srt

import requests

with open("video.mp4", "rb") as f:
    response = requests.post(
        "https://escribelo.4l3.org/v1/transcribe",
        files={"file": ("video.mp4", f, "video/mp4")},
        data={"tier": "accuracy", "language": "es", "output": "srt"},
    )

with open("subtitulos.srt", "w") as f:
    f.write(response.text)
print("Subtítulos guardados ✓")

const formData = new FormData();
formData.append("file", videoFile);
formData.append("tier", "accuracy");
formData.append("output", "srt");

const response = await fetch("https://escribelo.4l3.org/v1/transcribe", {
  method: "POST",
  body: formData,
});
const srt = await response.text();
console.log(srt);

Respuesta:

1
00:00:00,000 --> 00:00:02,400
Hola, bienvenidos al podcast de hoy.

2
00:00:02,800 --> 00:00:05,100
Hoy vamos a hablar de inteligencia artificial.

Probar la API

Haz llamadas reales a la API directamente desde aqui. Sin API key necesaria para el plan gratuito.

POST /v1/transcribe/url Transcribir desde URL

Límites de uso

Free (sin registro): 60 minutos de audio/mes por IP. Archivos hasta 100 MB.

Pro ($9/mes): 300 min/mes. Prioridad en cola.

Scale ($29/mes): 1,800 min/mes. Webhooks. API key dedicada.

PAYG: $0.005/minuto. Sin límite mensual.

Formatos de salida: JSON (con timestamps), SRT, VTT, texto plano.

SDK Python

Instala el SDK oficial y úsalo en 3 líneas:

pip install escribelo

Ejemplo:

from escribelo import Escribelo

client = Escribelo()  # Free tier, no API key needed

result = client.transcribe("meeting.mp3")
print(result["text"])

Paquete: escribelo · Compatible con Python 3.8+

Recursos API

Descarga la especificación para tu herramienta favorita:

OpenAPI 3.1 (JSON) Swagger UI

Compatible con Postman, Insomnia, Swagger, y cualquier cliente OpenAPI.

Empieza gratis

No necesitas API key para empezar. Simplemente haz tu primera llamada:

curl https://escribelo.4l3.org/api?format=json

Ir a Escribelo Ver planes

¿Prefieres JSON? Llama este URL con Accept: application/json o agrega ?format=json.