Étude de castranscriptyt

Des transcriptions sur demande.

transcriptyt est une API REST qui fournit les transcriptions YouTube et les métadonnées des vidéos et des chaînes, avec clés d'API et limites de débit par forfait.

Statut
En ligne sur transcriptyt.com. Elle alimente aussi sponsoredyt.
Rôle
L'API, son cache et ses forfaits.
Construit avec
  • Python
  • FastAPI
  • PostgreSQL
  • Clerk
  • Sentry
  • Docker

Le problème

Obtenir des transcriptions YouTube dans du code, c'est composer avec les requêtes bloquées, les nouvelles tentatives et les formats de sous-titres. transcriptyt regroupe tout ça derrière une seule API authentifiée.

Ce qui a été construit

  • Des transcriptions en JSON, en texte brut, en SRT ou en WebVTT, avec un ordre de préférence des langues et un filtre sous-titres manuels ou générés.
  • Les métadonnées des vidéos, dont le titre, la chaîne, la durée, les vues, la date de publication et le statut réservé aux membres, et celles des chaînes.
  • Des clés d'API et des forfaits gérés par Clerk, avec des limites à la minute et au mois, et des en-têtes de limite de débit sur les réponses authentifiées.
  • Une vérification d'état publique qui rapporte l'état de la base de données et du disjoncteur.

Comment ça marche

  • FastAPI avec un cache dans PostgreSQL (JSONB) : vérifier le cache, puis YouTube, puis enregistrer la réponse.
  • Un disjoncteur et de nouvelles tentatives avec délai croissant autour des appels à YouTube, et un repli sur la dernière réponse en cache, pour que les réponses continuent quand YouTube résiste.
  • Des en-têtes de sécurité, une limite de taille des requêtes, des journaux assainis et une surveillance par Sentry.