API de transcricións de YouTube

Unha petición e tes a transcrición completa. Só pagas os vídeos que obtés.

Inicio rápido

Inicia sesión e crea unha chave API no panel da API. Recibes 10 créditos gratuítos (5 transcricións).
Envía a chave na cabeceira X-API-Key cun URL de YouTube ou un ID de vídeo.
Compra un paquete de créditos cando precises máis, ou activa a 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 (ligazón watch, youtu.be, shorts, embed ou live). Usa isto ou video_id.
video_id: O ID de vídeo de YouTube de 11 caracteres.
lang: Idioma de subtítulos preferido, por exemplo en, de ou pt-BR. Por defecto en. Se falta ese idioma, devólvese a pista orixinal e a resposta indica o seu idioma real.
format: json (segmentos con marcas de tempo, por defecto), text ou 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();

Resposta

{
  "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 }
  ]
}

Erros

401	invalid_key	Chave API ausente, incorrecta ou revogada.
400	invalid_input	Non se puido ler o URL ou o ID do vídeo.
402	insufficient_credits	O teu saldo é inferior a 2 créditos.
402	budget_exceeded	Chegaches ao límite mensual de créditos que estableciches.
404	no_transcript	O vídeo non ten subtítulos, ou é privado, en directo ou eliminado. Non se cobra.
429	rate_limited	Máis de 60 peticións por minuto cunha chave. Agarda os segundos de Retry-After.
502	upstream_error	YouTube non respondeu a tempo. Non se cobra, téntao máis tarde.

Consultar o saldo

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

Prezos

Cada transcrición custa 2 créditos. Os créditos non caducan nunca. Os subscritores Pro reciben 100 créditos extra cada mes.

Paquete	Créditos	Transcricións	Prezo	Por transcrición
Starter	100	50	4,49 $	0,090 $
Pro	500	250	13,99 $	0,056 $
Scale	2.000	1.000	37,99 $	0,038 $
Business	5.000	2.500	74,99 $	0,030 $

Recarga automática, orzamentos e alertas

A recarga automática compra un paquete coa tarxeta gardada cando o saldo baixa dun limiar que escolles.
Un orzamento mensual de recarga limita canto pode gastar a recarga automática, e un límite mensual de créditos detén as peticións cando se alcanza.
As alertas por correo avísante cando o saldo é baixo, cando chegas ao 80% do límite mensual ou cando falla unha recarga.

Límites e uso xusto

60 peticións por minuto por chave, ata 5 chaves activas por conta. A API devolve subtítulos que xa existen en YouTube; non transcribe audio. Es responsable de usar as transcricións respectando os dereitos dos propietarios dos vídeos e as condicións de YouTube.

Preguntas frecuentes

Volvo pagar polo mesmo vídeo?: Si, cada petición correcta custa 2 créditos, pero os vídeos repetidos sérvense desde a nosa caché en milisegundos.
Que pasa cando un vídeo non ten subtítulos?: Recibes un erro no_transcript e non se descontan créditos.
É compatible con outras API de transcricións?: A petición e a resposta seguen a estrutura habitual de url, lang e segments, así que cambiar adoita significar só modificar o URL base e a chave.