API de transcription YouTube

Une requête, la transcription complète. Vous ne payez que les vidéos que vous récupérez.

Démarrage rapide

Connectez-vous et créez une clé API dans le tableau de bord API. Vous recevez 10 crédits offerts (5 transcriptions).
Envoyez la clé dans l'en-tête X-API-Key avec une URL YouTube ou un identifiant de vidéo.
Achetez un pack de crédits quand il vous en faut plus, ou activez la recharge automatique.

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"}'

Requête

POST /api/v1/transcript

url: URL YouTube (lien watch, youtu.be, shorts, embed ou live). Utilisez ceci ou video_id.
video_id: L'identifiant de vidéo YouTube de 11 caractères.
lang: Langue de sous-titres souhaitée, par exemple en, de ou pt-BR. Par défaut en. Si cette langue manque, la piste d'origine est renvoyée et la réponse indique sa langue réelle.
format: json (segments horodatés, par défaut), 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();

Réponse

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

Erreurs

401	invalid_key	Clé API manquante, erronée ou révoquée.
400	invalid_input	L'URL ou l'identifiant de vidéo n'a pas pu être lu.
402	insufficient_credits	Votre solde est inférieur à 2 crédits.
402	budget_exceeded	Vous avez atteint la limite mensuelle de crédits que vous avez fixée.
404	no_transcript	La vidéo n'a pas de sous-titres, ou elle est privée, en direct ou supprimée. Non facturé.
429	rate_limited	Plus de 60 requêtes par minute sur une clé. Attendez le nombre de secondes indiqué par Retry-After.
502	upstream_error	YouTube n'a pas répondu à temps. Non facturé, réessayez plus tard.

Consulter votre solde

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

Tarifs

Chaque transcription coûte 2 crédits. Les crédits n'expirent jamais. Les abonnés Pro reçoivent 100 crédits bonus chaque mois.

Pack	Crédits	Transcriptions	Prix	Par transcription
Starter	100	50	4,49 $US	0,090 $US
Pro	500	250	13,99 $US	0,056 $US
Scale	2 000	1 000	37,99 $US	0,038 $US
Business	5 000	2 500	74,99 $US	0,030 $US

Recharge automatique, budgets et alertes

La recharge automatique achète un pack avec votre carte enregistrée lorsque votre solde passe sous un seuil que vous choisissez.
Un budget mensuel de recharge plafonne ce que la recharge automatique peut dépenser, et une limite mensuelle de crédits arrête les requêtes une fois atteinte.
Des alertes par e-mail vous préviennent quand votre solde baisse, quand vous atteignez 80 % de votre limite mensuelle ou quand une recharge échoue.

Limites et usage équitable

60 requêtes par minute et par clé, jusqu'à 5 clés actives par compte. L'API renvoie les sous-titres qui existent déjà sur YouTube ; elle ne transcrit pas l'audio. Vous êtes responsable d'utiliser les transcriptions dans le respect des droits des propriétaires des vidéos et des conditions de YouTube.

FAQ

Est-ce que je paie à nouveau pour la même vidéo ?: Oui, chaque requête réussie coûte 2 crédits, mais les vidéos répétées sont servies depuis notre cache en quelques millisecondes.
Que se passe-t-il quand une vidéo n'a pas de sous-titres ?: Vous recevez une erreur no_transcript et aucun crédit n'est débité.
Est-elle compatible avec d'autres API de transcription ?: La requête et la réponse suivent la structure courante url, lang et segments, donc changer revient généralement à modifier l'URL de base et la clé.