API di trascrizione YouTube

Una richiesta, la trascrizione completa. Paghi solo i video che recuperi.

Avvio rapido

Accedi e crea una chiave API nella dashboard API. Ricevi 10 crediti gratuiti (5 trascrizioni).
Invia la chiave nell'intestazione X-API-Key con un URL di YouTube o un ID video.
Acquista un pacchetto di crediti quando te ne servono altri, oppure attiva la ricarica automatica.

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

Richiesta

POST /api/v1/transcript

url: URL di YouTube (link watch, youtu.be, shorts, embed o live). Usa questo oppure video_id.
video_id: L'ID video di YouTube di 11 caratteri.
lang: Lingua dei sottotitoli preferita, per esempio en, de o pt-BR. Predefinita: en. Se quella lingua manca, viene restituita la traccia originale e la risposta ne indica la lingua reale.
format: json (segmenti con timestamp, predefinito), 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();

Risposta

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

Errori

401	invalid_key	Chiave API mancante, errata o revocata.
400	invalid_input	Impossibile leggere l'URL o l'ID del video.
402	insufficient_credits	Il tuo saldo è inferiore a 2 crediti.
402	budget_exceeded	Hai raggiunto il limite mensile di crediti che hai impostato.
404	no_transcript	Il video non ha sottotitoli, oppure è privato, in diretta o rimosso. Non addebitato.
429	rate_limited	Più di 60 richieste al minuto su una chiave. Attendi i secondi indicati da Retry-After.
502	upstream_error	YouTube non ha risposto in tempo. Non addebitato, riprova più tardi.

Controlla il saldo

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

Prezzi

Ogni trascrizione costa 2 crediti. I crediti non scadono mai. Gli abbonati Pro ricevono 100 crediti bonus ogni mese.

Pacchetto	Crediti	Trascrizioni	Prezzo	Per trascrizione
Starter	100	50	4,49 USD	0,090 USD
Pro	500	250	13,99 USD	0,056 USD
Scale	2000	1000	37,99 USD	0,038 USD
Business	5000	2500	74,99 USD	0,030 USD

Ricarica automatica, budget e avvisi

La ricarica automatica acquista un pacchetto con la carta salvata quando il saldo scende sotto una soglia scelta da te.
Un budget mensile di ricarica limita quanto può spendere la ricarica automatica, e un limite mensile di crediti blocca le richieste quando viene raggiunto.
Gli avvisi via email ti informano quando il saldo è basso, quando raggiungi l'80% del limite mensile o quando una ricarica non riesce.

Limiti e uso corretto

60 richieste al minuto per chiave, fino a 5 chiavi attive per account. L'API restituisce sottotitoli già presenti su YouTube; non trascrive l'audio. Sei responsabile di usare le trascrizioni nel rispetto dei diritti dei proprietari dei video e dei termini di YouTube.

Domande frequenti

Pago di nuovo per lo stesso video?: Sì, ogni richiesta riuscita costa 2 crediti, ma i video ripetuti vengono serviti dalla nostra cache in millisecondi.
Cosa succede se un video non ha sottotitoli?: Ricevi un errore no_transcript e non vengono scalati crediti.
È compatibile con altre API di trascrizione?: Richiesta e risposta seguono la struttura comune url, lang e segments, quindi passare a noi di solito significa cambiare l'URL di base e la chiave.