Referencia
Fuentes
YouTube, TikTok, tus archivos y enlaces directos: URL aceptadas, qué hace cada modo y límites.
Actualizado
Sea cual sea la fuente, obtienes el mismo objeto de transcripción: texto, segmentos con tiempos y tiempos por palabra cuando los produjo la transcripción con IA. Límites para todas las fuentes: 2 horas y 250 MB.
Fuentes#
| Fuente | Enlaces aceptados | captions_only | auto / transcribe |
|---|---|---|---|
| YouTube | youtube.com/watch?v=…, youtu.be/…, /shorts/…, /live/… | Subtítulos del creador o automáticos, 1 crédito | Planes de pago |
| TikTok | tiktok.com/@user/video/…, enlaces para compartir vm.tiktok.com/… | Subtítulos del creador, 1 crédito | Planes de pago |
| Tu archivo | mp3, wav, m4a, ogg, aac, mp4, webm mediante POST /v1/uploads | No disponible | Planes de pago |
| Enlace directo | Cualquier URL https pública que sirva un archivo de audio o video | No disponible | Planes de pago |
GET /v1/capabilities con tu clave devuelve esta tabla para tu plan, así un cliente puede mostrar solo lo que va a funcionar.
Subtítulos#
- Solo videos públicos. Los videos privados, exclusivos para miembros o con restricción de edad fallan con un código
SOURCE_*. - YouTube tiene dos tipos: los subtítulos que subió el creador y los automáticos de YouTube.
caption_preferenceelige entre ellos; por defecto toma los del creador cuando existen. caption_languagespide pistas específicas, p. ej.["es", "en"].POST /v1/language-discoverieslista las que tiene un video de YouTube.- Los tiempos van por cada bloque de subtítulo (
timing_granularity: "segment").
Transcripción con IA#
- Escucha el audio; funciona con o sin subtítulos. Detecta el idioma o toma una pista en
language. - Devuelve tiempos por palabra y nivel de confianza (
timing_granularity: "word"). - Tarda más o menos una cuarta parte de la duración del archivo. Usa
?wait=25o un webhook en lugar de consultar sin pausa. - 2 créditos por minuto iniciado, con un mínimo de 1 minuto; limita un trabajo con
max_credits.