Giới hạn tốc độ & thanh toán

Chi phí mỗi lần gọiSao chép liên kết

Bạn trả tiền cho câu trả lời, không phải lần thử: chỉ 200 bị tính phí. Lỗi, timeout và lần tìm rỗng đều miễn phí.

/discover/* là Khám phá, /analytics/* Phân tích, /resolve* Phân giải. GET /stats là bộ đếm danh mục công khai (Thống kê), không khóa, không phí. /resolve/batch nhận tối đa 100 mã và tính một nhóm cho mỗi 10 mã duy nhất đã bắt đầu.

Tài khoản mới có $0.02 tín dụng miễn phí, khoảng 50 lần tìm kiếm: đủ dựng một thứ nhỏ.

Trang lớn hơn thì tốn hơnSao chép liên kết

/query, /idols và /random nhận num từ 1 đến 50. Giá trên là cho 10 kết quả; xin nhiều hơn thì giá tăng theo kích thước trang, làm tròn lên:

cost = max(base price, base price × num ÷ 10)

Với /query, mỗi 1.000 lần gọi:

Năm lần num=10 tốn bằng một lần num=50. Kích thước trang là tiện lợi, không phải giảm giá.

Cùng công thức cho /discover/* và /analytics/*, nơi một số endpoint có num mặc định trên 10 và lần gọi mặc định đã tốn hơn mức cơ bản:

Truyền num=10 hoặc thấp hơn để trả giá cơ bản. Endpoint ngoài bảng không nhận num (hoặc mặc định 10 hoặc thấp hơn) và luôn ở mức cơ bản.

Không tìm thấy gì không phải là lỗiSao chép liên kết

/query không khớp gì vẫn trả 200 với count: 0 và mảng results rỗng, miễn phí. Kiểm tra count, đừng nhìn mã trạng thái.

Phân phối bản xem trướcSao chép liên kết

Đoạn xem trước đến từ cdn.javinfo.dev, tính phí theo dữ liệu, không theo lần gọi: $0.30 mỗi GB, chỉ tính lần đầu kéo clip về từ nguồn. Sau đó chúng nằm trong vùng lưu trữ đối tượng của chúng tôi, mọi lượt xem về sau đều miễn phí cho tất cả.

Chất lượng tùy tài khoản: nạp tiền một lần là nhận bản tốt nhất của tựa phim; trước đó là chất lượng tiêu chuẩn.

URL video gắn với tài khoản và không bao giờ hết hạn, nên liên kết lưu từ năm ngoái vẫn phát được. Đổi lại, ai cầm liên kết đó xem bằng số dư của bạn: giữ URL xem trước như giữ khóa API.

Bạn gọi được nhanh đến đâuSao chép liên kết

Giới hạn theo tài khoản, dùng chung mọi khóa.

Vượt quá, bạn nhận 429 kèm Retry-After cho biết chờ bao lâu. Giới hạn tự nới ngay khi khoản thanh toán đầu tiên hoàn tất, không cần xin hay điền biểu mẫu.

Giới hạn theo giờ với các nhà cung cấp trực tiếpSao chép liên kết

FANZA, DMM và các nhà cung cấp từ danh mục của chúng tôi không có giới hạn theo giờ. Nhà cung cấp vẫn lấy trực tiếp từ nguồn lúc có yêu cầu tốn một yêu cầu thật, nên chúng dùng chung hạn mức theo giờ:

• 6.000 kết quả mỗi giờ, mỗi tài khoản. Vượt quá, /query trả về 429 kèm Retry-After.
• 3.000 lần gọi mỗi giờ mỗi nhà cung cấp, tính chung mọi người dùng. Khi một nguồn quá tải, chúng tôi loại nó khỏi lượt tìm và trả lời bằng nguồn còn lại. Nếu đã ghim nó bằng providers=, không còn dự phòng và bạn nhận 503 kèm Retry-After.

Dùng bình thường không tới gần con số đó: hạn mức tài khoản cao hơn hẳn giờ bận nhất từng ghi nhận. Nó tồn tại để một script chạy loạn không làm cả nguồn bị chặn với mọi người.

Chốt chặn liên quan: phân trang quá trang 50 với q rỗng trả 422. Lật sâu qua bộ lọc mà không có chữ để tìm là quét sạch danh mục, không phải tìm kiếm. Thêm q, hoặc thu hẹp bộ lọc.

Khi số dư cạnSao chép liên kết

API trả 402 Payment Required và không tính phí. Retry-After là một giờ, gợi ý cho máy khách tự động, không phải lệnh khóa: nạp tiền, lần gọi tiếp theo đi qua ngay.

Nạp tiền từ bảng điều khiển. Khoản từ $15 được cộng tín dụng thưởng ngoài số tiền trả; từ $50 nhận mức lớn nhất, tối đa 10%. Con số chính xác quay ngẫu nhiên từng lần thanh toán nên thay đổi trong cùng bậc.

Header phản hồiSao chép liên kết

• X-Response-Time-Ms — thời gian xử lý.
• X-Balance-Remaining — tín dụng còn lại sau lần gọi.
• X-Cache: HIT | MISS — phản hồi từ bộ nhớ đệm. Có trên /movie, /query, /idols và các endpoint khám phá, phân tích, resolve được cache. Trúng cache miễn phí.
• X-Degraded — lượt đọc chỉ mục thất bại khi dựng câu trả lời; giá trị là số lượt. Câu trả lời miễn phí và không được cache.
• Retry-After — có mặt trên 429, 402 và 503. Hãy tôn trọng nó.

Danh sách mã trạng thái đầy đủ ở Lỗi.