API de transcripciones de YouTube

Una petición y tienes la transcripción completa. Solo pagas por los vídeos que obtienes.

Inicio rápido

Inicia sesión y crea una clave API en el panel de la API. Recibes 10 créditos gratis (5 transcripciones).
Envía la clave en la cabecera X-API-Key con una URL de YouTube o un ID de vídeo.
Compra un paquete de créditos cuando necesites más, o activa la recarga automática.

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: sv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'

Petición

POST /api/v1/transcript

url: URL de YouTube (enlace watch, youtu.be, shorts, embed o live). Usa esto o video_id.
video_id: El ID de vídeo de YouTube de 11 caracteres.
lang: Idioma de subtítulos preferido, por ejemplo en, de o pt-BR. Por defecto en. Si falta ese idioma, se devuelve la pista original y la respuesta indica su idioma real.
format: json (segmentos con marcas de tiempo, por defecto), text o srt.

import requests

response = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": "sv_live_your_key"},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=120,
)
print(response.json()["text"])

const response = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: { "X-API-Key": process.env.SUMVIDEO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();

Respuesta

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "is_generated": false,
  "credits_used": 2,
  "credits_remaining": 98,
  "segments": [
    { "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
  ]
}

Errores

401	invalid_key	Clave API ausente, incorrecta o revocada.
400	invalid_input	No se pudo leer la URL o el ID del vídeo.
402	insufficient_credits	Tu saldo es inferior a 2 créditos.
402	budget_exceeded	Has alcanzado el límite mensual de créditos que estableciste.
404	no_transcript	El vídeo no tiene subtítulos, o es privado, en directo o eliminado. No se cobra.
429	rate_limited	Más de 60 peticiones por minuto con una clave. Espera los segundos de Retry-After.
502	upstream_error	YouTube no respondió a tiempo. No se cobra, inténtalo más tarde.

Consultar tu saldo

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

Precios

Cada transcripción cuesta 2 créditos. Los créditos no caducan. Los suscriptores Pro reciben 100 créditos extra cada mes.

Paquete	Créditos	Transcripciones	Precio	Por transcripción
Starter	100	50	4,49 US$	0,090 US$
Pro	500	250	13,99 US$	0,056 US$
Scale	2000	1000	37,99 US$	0,038 US$
Business	5000	2500	74,99 US$	0,030 US$

Recarga automática, presupuestos y alertas

La recarga automática compra un paquete con tu tarjeta guardada cuando tu saldo baja de un umbral que tú eliges.
Un presupuesto mensual de recarga limita cuánto puede gastar la recarga automática, y un límite mensual de créditos detiene las peticiones al alcanzarse.
Las alertas por correo te avisan cuando tu saldo es bajo, cuando llegas al 80 % de tu límite mensual o cuando falla una recarga.

Límites y uso justo

60 peticiones por minuto por clave, hasta 5 claves activas por cuenta. La API devuelve subtítulos que ya existen en YouTube; no transcribe audio. Eres responsable de usar las transcripciones respetando los derechos de los propietarios de los vídeos y los términos de YouTube.

Preguntas frecuentes

¿Pago otra vez por el mismo vídeo?: Sí, cada petición correcta cuesta 2 créditos, pero los vídeos repetidos se sirven desde nuestra caché en milisegundos.
¿Qué pasa si un vídeo no tiene subtítulos?: Recibes un error no_transcript y no se descuentan créditos.
¿Es compatible con otras API de transcripciones?: La petición y la respuesta siguen la estructura habitual de url, lang y segments, así que cambiar suele consistir en modificar la URL base y la clave.