API Chép Lời YouTube không hoạt động? Danh sách chẩn đoán

Danh sách chẩn đoán

Đối chiếu mã lỗi của bạn (hoặc hình dạng phản hồi) với bảng dưới đây.

Bị chặn trên AWS, GCP, Azure, hoặc VPS?

Nếu một script chạy hoàn hảo trên laptop của bạn rồi thất bại ngay khi được triển khai lên máy chủ đám mây, gần như luôn là vì lý do này: endpoint lấy phụ đề của YouTube chặn toàn bộ dải IP của trung tâm dữ liệu, không chỉ những IP riêng lẻ lạm dụng. Không gian IP của mọi nhà cung cấp đám mây lớn cuối cùng đều bị ảnh hưởng, vì hàng nghìn script không liên quan chia sẻ cùng dải địa chỉ.

Could not retrieve a transcript for the video https://www.youtube.com/watch?v=...!
This is most likely caused by:
YouTube is blocking requests from your IP.

Các cách thực tế để khắc phục, xếp gần đúng theo mức độ công sức:

• Định tuyến yêu cầu qua một pool proxy dân dụng hoặc di động - đôi khi hiệu quả, nhưng ngày càng có nhiều báo cáo rằng ngay cả các thiết lập proxy dân dụng xoay vòng trả phí vẫn thất bại. Không phải giải pháp vĩnh viễn.
• Xoay vòng giữa nhiều nhà cung cấp đám mây hoặc khu vực - mua thêm thời gian cho đến khi các dải đó cũng bị đánh dấu.
• Cache mạnh để không phải lấy lại cùng một video - giảm tần suất bị chặn, không loại bỏ hoàn toàn.
• Dùng một API được lưu trữ đã vận hành sẵn hạ tầng này - vấn đề chuyển từ 'dự án của bạn' sang 'ai đó có công việc thực sự là giữ cho nó hoạt động'.

Đó chính là khoảng trống thực sự mà API Chép Lời YouTube của chúng tôi lấp đầy - không phải một thư viện khác, mà là hạ tầng đã được xây dựng riêng cho vấn đề này.

Bạn gặp lỗi PoTokenRequired?

Một kiểu lỗi mới hơn: endpoint phụ đề của YouTube ngày càng yêu cầu một token chứng minh nguồn gốc được tạo ra tại thời điểm chạy bởi chính JavaScript trình phát của nó - không phải cookie, không phải kiểm tra uy tín IP, mà là một giá trị mật mã học. Một yêu cầu HTTP đơn thuần không có cách nào tạo ra nó.

Xem chi tiết kỹ thuật thực tế tại jdepoix/youtube-transcript-api#592 - tính đến báo cáo đó, không có cách khắc phục nào được ghi lại trong thư viện mã nguồn mở.

Đây chính xác là loại vấn đề mà một API được lưu trữ được tạo ra để hấp thụ - gọi một endpoint và nhận lại bản chép lời hoặc một lỗi rõ ràng, mà không cần tự giải quyết việc tạo token.

API của chúng tôi trả về gì cho mỗi lỗi

Nếu bạn đã dùng API của chúng tôi và muốn phân nhánh theo lỗi chính xác thay vì đoán chỉ từ trạng thái HTTP, mọi lỗi đều trả về kèm một trường `code` ổn định:

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

# A failure looks like:
# { "success": false, "code": "TRANSCRIPT_DISABLED", "message": "Transcripts are disabled for this video." }

Tài liệu tham khảo tham số đầy đủ và mọi mã trạng thái đều có trong tài liệu API.