Limites de débit et facturation
Ce que coûte un appel, à quelle cadence l'envoyer, et ce qui arrive quand le crédit manque.
Coût par appel
Vous payez les réponses, pas les tentatives : seul un 200 est facturé. Erreurs, timeouts et
recherches vides sont gratuits.
| Endpoint | Pour 1 000 appels |
|---|---|
/movie | $0.80 |
/query | $0.40 |
/idols | $0.50 |
/random | $0.20 |
/discover/* | $0.40 |
/resolve/compare, /resolve/provenance, /resolve/streams | $0.40 |
/resolve (carte) | $1.20 |
/resolve/batch | $0.40 par groupe entamé de 10 codes uniques |
/analytics/* | $0.60 |
GET /stats | gratuit |
/discover/* est Découvrir, /analytics/* Analytique,
/resolve* Résolution. GET /stats, compteur public du catalogue
(Statistiques), est sans clé ni frais. /resolve/batch prend jusqu'à 100 codes et
facture un groupe par 10 codes uniques entamés.
Les nouveaux comptes démarrent avec $0.02 de crédit offert, environ 50 recherches : de quoi commencer.
Les grandes pages coûtent plus cher
/query, /idols et /random acceptent un num de 1 à 50. Les tarifs valent pour 10
résultats ; au-delà, le prix suit la taille de page, arrondi au supérieur :
cost = max(base price, base price × num ÷ 10)Pour /query, pour 1 000 appels :
num | Pour 1 000 appels |
|---|---|
| 1–10 | $0.40 |
| 20 | $0.80 |
| 50 | $2.00 |
Cinq appels à num=10 coûtent le prix d'un appel à num=50. La taille de page est un confort,
pas une remise.
Même formule pour /discover/* et /analytics/*, où plusieurs endpoints utilisent par défaut un
num supérieur à 10 et coûtent déjà plus que le tarif de base :
| Endpoint | num par défaut | Pour 1 000 appels |
|---|---|---|
/discover/similar | 12 | $0.48 |
/discover/trending | 20 | $0.80 |
/discover/underrated | 20 | $0.80 |
/discover/series | 20 | $0.80 |
/discover/for-you | 20 | $0.80 |
/discover/studios | 30 (20 avec q) | $1.20 ($0.80 avec q) |
/discover/tags | 30 | $1.20 |
/discover/genres | 60 | $2.40 |
/analytics/leaderboard | 20 | $1.20 |
/analytics/idols/costars | 15 | $0.90 |
Passez num=10 ou moins pour le tarif de base. Les endpoints absents du tableau ne prennent
pas de num (ou en utilisent 10 ou moins) et coûtent toujours ce tarif.
/random renvoie 10 résultats par défaut, contre 20 avant. Passez num=20 pour
l'ancienne taille : mêmes résultats, prix par appel doublé.
Aucun résultat n'est pas une erreur
/query sans résultat renvoie 200, count: 0 et un tableau results vide, gratuit. Vérifiez
count, pas le code d'état.
Diffusion des aperçus
Les clips d'aperçu viennent de cdn.javinfo.dev, facturés au volume, pas à l'appel : $0.30 par Go,
prélevés une fois, au premier tirage depuis la source. Ensuite ils vivent dans notre stockage
objet ; toute lecture suivante est gratuite, pour tout le monde.
La qualité dépend du compte : après un rechargement, la meilleure version d'un titre ; avant, la qualité standard.
Les URLs vidéo sont liées à votre compte et n'expirent jamais : un lien enregistré l'an dernier joue toujours. Mais celui à qui vous le confiez regarde sur votre solde. Traitez ces URLs comme une clé API.
À quelle cadence vous pouvez appeler
Les limites s'appliquent par compte, toutes vos clés confondues.
| État du compte | Requêtes par minute |
|---|---|
| Avant le premier rechargement | 10 |
| Après le premier rechargement | 60 |
Au-delà, 429 avec Retry-After indiquant le temps d'attente. Le plafond se lève seul dès que le
premier paiement est validé, sans demande ni formulaire.
Limites horaires sur les fournisseurs en direct
FANZA, DMM et les fournisseurs servis depuis notre catalogue n'ont pas de plafond horaire. Ceux interrogés à la source consomment une vraie requête en amont et partagent un budget horaire :
- 6 000 résultats par heure et par compte. Au-delà,
/queryrenvoie429avecRetry-After. - 3 000 appels par heure et fournisseur, tous utilisateurs confondus. Si l'un sature, nous le
retirons de la recherche et répondons avec les autres. Si vous l'avez épinglé avec
providers=, il ne reste aucun repli : vous obtenez503avecRetry-After.
Un usage normal n'en approche pas : le budget par compte dépasse largement l'heure légitime la plus chargée enregistrée. Il empêche un script emballé de faire bloquer une source pour tous.
Autre garde-fou : paginer au-delà de la page 50 avec un q vide renvoie 422. Parcourir un filtre
sans texte de recherche énumère un catalogue. Ajoutez un q, ou resserrez le
filtre.
Quand votre solde est épuisé
L'API renvoie 402 Payment Required sans facturer. Retry-After vaut une heure, indication pour
les clients automatisés, pas un verrouillage : rechargez, et l'appel suivant passe.
Rechargez depuis votre tableau de bord. Les paiements de $15 ou plus donnent un crédit bonus ; dès $50, le bonus est maximal, jusqu'à 10 %. Le montant est tiré à chaque paiement et varie dans le palier.
En-têtes de réponse
X-Response-Time-Ms— temps de traitement.X-Balance-Remaining— crédit restant après l'appel.X-Cache: HIT | MISS— réponse servie depuis le cache. Présent sur/movie,/query,/idolset les endpoints de découverte, d'analytique et de résolution en cache. Un hit est gratuit.X-Degraded— lectures d'index échouées pendant l'assemblage ; la valeur est leur nombre. Réponse gratuite, non mise en cache.Retry-After— présent sur429,402et503. Respectez-le.
Liste complète des codes dans Erreurs.