YouTube Transcript API

Ένα αίτημα, ολόκληρη η απομαγνητοφώνηση. Πληρώνετε μόνο για τα βίντεο που λαμβάνετε.

Γρήγορη εκκίνηση

Συνδεθείτε και δημιουργήστε κλειδί API στον πίνακα API. Παίρνετε 10 δωρεάν μονάδες (5 απομαγνητοφωνήσεις).
Στείλτε το κλειδί στην κεφαλίδα X-API-Key μαζί με ένα URL του YouTube ή ένα ID βίντεο.
Αγοράστε πακέτο μονάδων όταν χρειάζεστε περισσότερες ή ενεργοποιήστε την αυτόματη επαναφόρτιση.

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

Αίτημα

POST /api/v1/transcript

url: URL του YouTube (σύνδεσμος watch, youtu.be, shorts, embed ή live). Χρησιμοποιήστε αυτό ή το video_id.
video_id: Το ID βίντεο YouTube 11 χαρακτήρων.
lang: Προτιμώμενη γλώσσα υποτίτλων, για παράδειγμα en, de ή pt-BR. Προεπιλογή en. Αν λείπει αυτή η γλώσσα, επιστρέφεται το αρχικό κομμάτι και η απάντηση δηλώνει την πραγματική του γλώσσα.
format: json (τμήματα με χρονοσημάνσεις, προεπιλογή), text ή 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();

Απάντηση

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

Σφάλματα

401	invalid_key	Κλειδί API που λείπει, είναι λάθος ή έχει ανακληθεί.
400	invalid_input	Δεν ήταν δυνατή η ανάγνωση του URL ή του ID βίντεο.
402	insufficient_credits	Το υπόλοιπό σας είναι κάτω από 2 μονάδες.
402	budget_exceeded	Φτάσατε το μηνιαίο όριο μονάδων που ορίσατε.
404	no_transcript	Το βίντεο δεν έχει υπότιτλους ή είναι ιδιωτικό, ζωντανό ή καταργημένο. Δεν χρεώνεται.
429	rate_limited	Πάνω από 60 αιτήματα το λεπτό με ένα κλειδί. Περιμένετε όσα δευτερόλεπτα δείχνει το Retry-After.
502	upstream_error	Το YouTube δεν απάντησε εγκαίρως. Δεν χρεώνεται, δοκιμάστε ξανά αργότερα.

Ελέγξτε το υπόλοιπό σας

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

Τιμές

Κάθε απομαγνητοφώνηση κοστίζει 2 μονάδες. Οι μονάδες δεν λήγουν ποτέ. Οι συνδρομητές Pro παίρνουν 100 μονάδες μπόνους κάθε μήνα.

Πακέτο	Μονάδες	Απομαγνητοφωνήσεις	Τιμή	Ανά απομαγνητοφώνηση
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 $

Αυτόματη επαναφόρτιση, προϋπολογισμοί και ειδοποιήσεις

Η αυτόματη επαναφόρτιση αγοράζει ένα πακέτο με την αποθηκευμένη κάρτα σας όταν το υπόλοιπο πέσει κάτω από ένα όριο που επιλέγετε.
Ένας μηνιαίος προϋπολογισμός επαναφόρτισης περιορίζει πόσα μπορεί να ξοδέψει η αυτόματη επαναφόρτιση, και ένα μηνιαίο όριο μονάδων σταματά τα αιτήματα όταν συμπληρωθεί.
Οι ειδοποιήσεις μέσω email σάς ενημερώνουν όταν το υπόλοιπο είναι χαμηλό, όταν φτάσετε το 80% του μηνιαίου ορίου ή όταν αποτύχει μια επαναφόρτιση.

Όρια και δίκαιη χρήση

60 αιτήματα το λεπτό ανά κλειδί, έως 5 ενεργά κλειδιά ανά λογαριασμό. Το API επιστρέφει υπότιτλους που υπάρχουν ήδη στο YouTube· δεν απομαγνητοφωνεί ήχο. Είστε υπεύθυνοι να χρησιμοποιείτε τις απομαγνητοφωνήσεις σύμφωνα με τα δικαιώματα των κατόχων των βίντεο και τους όρους του YouTube.

Συχνές ερωτήσεις

Πληρώνω ξανά για το ίδιο βίντεο;: Ναι, κάθε επιτυχημένο αίτημα κοστίζει 2 μονάδες, αλλά τα επαναλαμβανόμενα βίντεο εξυπηρετούνται από την προσωρινή μνήμη μας σε χιλιοστά του δευτερολέπτου.
Τι γίνεται όταν ένα βίντεο δεν έχει υπότιτλους;: Λαμβάνετε σφάλμα no_transcript και δεν αφαιρούνται μονάδες.
Είναι συμβατό με άλλα API απομαγνητοφώνησης;: Το αίτημα και η απάντηση ακολουθούν τη συνηθισμένη δομή url, lang και segments, οπότε η μετάβαση συνήθως σημαίνει απλώς αλλαγή του βασικού URL και του κλειδιού.