Hướng dẫn kết nối tác tử với Huangguo
Danh mục công khai chỉ đọc, không cần đăng nhập. Chọn tác phẩm dựa trên dữ liệu có nguồn rồi mở trình phát thông thường. Quy trình khu vực và xác nhận độ tuổi hiện có vẫn áp dụng.
Hướng dẫn có 12 ngôn ngữ; tham số locale của API hiện chỉ nhận zh (tiếng Trung giản thể) và en (tiếng Anh). Bản dịch hướng dẫn không bổ sung ngôn ngữ cho API.
MCP
Sao chép địa chỉ Streamable HTTP này vào ứng dụng khách MCP:
https://huangguodrama.ai/api/agent/mcp/
search_titles— Tìm và lọc tác phẩm đã công bốget_title— Thông tin tác phẩm và bằng chứnglist_episodes— Video đã công bố và liên kết phát
HTTP
curl 'https://huangguodrama.ai/api/agent/v1/search/?locale=en&limit=10' curl 'https://huangguodrama.ai/api/agent/v1/titles/10438/?locale=en' curl 'https://huangguodrama.ai/api/agent/v1/titles/10438/episodes/?page=1&limit=20'
Bộ lọc và giới hạn
q, genre, audio, subtitle, completeness, min_duration, max_duration, duration_scope, locale, featured, page, limit
genre dùng ID thể loại được trả về. Mã ngôn ngữ dựa trên dữ liệu đo của media (ví dụ zh, en, zh-Hans); bộ lọc audio/subtitle yêu cầu mọi video đã công bố đều khớp. completeness: complete, partial, unknown. Thời lượng tính bằng giây; duration_scope: published (mặc định) hoặc complete_work. locale: zh hoặc en; featured: true hoặc false. Giá trị chưa biết không đáp ứng điều kiện bắt buộc.
Mặc định 10 kết quả, tối đa 20 mỗi trang; tổng cộng 60 yêu cầu mỗi IP mỗi phút cho HTTP và MCP. Từ khóa không quá 160 ký tự; yêu cầu MCP không quá 16 KiB. Lỗi: 400 đầu vào không hợp lệ, 403 Origin không được phép, 404 tác phẩm không tồn tại/chưa công bố, 413 nội dung yêu cầu quá lớn, 429 vượt giới hạn, 503 đã tắt/không khả dụng. Hỗ trợ yêu cầu từ máy chủ không có Origin.
Phạm vi và bằng chứng
834 tác phẩm đã công bố; danh sách cố định 30 tác phẩm nổi bật được chọn theo số lần bắt đầu phát trong bảy ngày. Thời điểm ghi nhận danh sách: 2026-09-20T10:46:04.829Z
Mỗi phản hồi có updated_at và thời điểm đo. Ngôn ngữ trang, ngôn ngữ media, thời lượng đã công bố và thời lượng toàn tác phẩm là các dữ liệu riêng. Không có bằng chứng thì giá trị là null. Trailer và bản phát hành một phần không được coi là phim bộ hoàn chỉnh. Thiếu thông tin cốt truyện mở rộng, nhân vật hoặc đánh giá sẽ được nêu rõ; dịch vụ không gọi mô hình đề xuất.
Ghi nhận nguồn truy cập và kiểm thử
watch_url là URL chuẩn. attributed_watch_url thêm dấu có chữ ký máy chủ, gắn với tác phẩm và có hiệu lực 24 giờ. Yêu cầu, lượt đến trình duyệt, lượt phát thực tế, thời gian xem cộng dồn 30 giây và lượt nhấp tập tiếp theo được đo riêng. Đặt X-Agent-Test: true cho yêu cầu thử nghiệm; dấu có chữ ký giữ lại cờ này. Tên ứng dụng khách và User-Agent chỉ là thông tin chẩn đoán, không phải danh tính tác tử đã xác thực.