レート制限と料金
1回の呼び出しの料金、送れる速さ、クレジットが尽きたときの動作。
1回の呼び出しの料金
支払うのは結果だけ。課金されるのは 200 のみです。エラー、タイムアウト、結果ゼロの検索は
無料です。
| エンドポイント | 1,000 コールあたり |
|---|---|
/movie | $0.80 |
/query | $0.40 |
/idols | $0.50 |
/random | $0.20 |
/discover/* | $0.40 |
/resolve/compare、/resolve/provenance、/resolve/streams | $0.40 |
/resolve（カード） | $1.20 |
/resolve/batch | 開始した10個のユニーク品番ごとに $0.40 |
/analytics/* | $0.60 |
GET /stats | 無料 |
/discover/* は探索、/analytics/* は分析、
/resolve* は正規化の画面です。GET /stats は公開カタログカウンター
（統計）で、キー不要・無料。1回の /resolve/batch は最大100品番、開始した
10個のユニーク品番ごとに1グループ課金です。
新規アカウントには $0.02 の無料クレジット、検索およそ50回分が付きます。小さなものを1つ 作るには十分です。
ページが大きいほど高くなります
/query、/idols、/random は 1〜50 の num を受け付けます。上の価格は結果10件分。
それ以上はページサイズに比例して上がります（切り上げ）：
cost = max(base price, base price × num ÷ 10)/query の場合、1,000 コールあたりでは：
num | 1,000 コールあたり |
|---|---|
| 1–10 | $0.40 |
| 20 | $0.80 |
| 50 | $2.00 |
num=10 で5回と num=50 で1回は同じ料金です。ページサイズは手間を省くつまみで、割引では
ありません。
同じ式が /discover/* と /analytics/* にも適用されます。いくつかはデフォルトの num が
10を超え、デフォルトのまま基本料金より高くなります：
| エンドポイント | デフォルトの num | 1,000 コールあたり |
|---|---|---|
/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（q ありなら 20） | $1.20（q ありなら $0.80） |
/discover/tags | 30 | $1.20 |
/discover/genres | 60 | $2.40 |
/analytics/leaderboard | 20 | $1.20 |
/analytics/idols/costars | 15 | $0.90 |
num=10 以下なら基本料金。表にないエンドポイントは num を受け付けない（またはデフォルトが
10以下）ので、常に基本料金です。
/random のデフォルトは20件から10件になりました。以前の件数が必要なら num=20 を渡して
ください。結果は同じ、1回あたりの料金は2倍です。
結果ゼロはエラーではありません
/query が何にもマッチしないときは 200 に count: 0 と空の results 配列が返り、課金
されません。ステータスコードではなく count を見てください。
プレビュー配信
プレビュークリップは cdn.javinfo.dev から配信され、コール数ではなくデータ量で課金されます。
1GB あたり $0.30、ソースから初めて取得したときだけです。以降は自前のオブジェクトストレージ
に保存され、2回目からの再生は誰にとっても無料です。
画質はアカウント次第。チャージ後はその作品の最高画質、以前は標準画質です。
動画 URL はアカウントに紐づき、有効期限はありません。去年のリンクが今も再生できるのは意図 どおり。ただし渡した相手はあなたの残高で視聴します。プレビュー URL は API キー並みに慎重に 扱ってください。
呼び出せる速さ
制限はアカウント単位、全キー共有です。
| アカウントの状態 | 1分あたりのリクエスト数 |
|---|---|
| 初回チャージ前 | 10 |
| 初回チャージ後 | 60 |
超過すると 429 と Retry-After が返ります。上限は最初の支払い確定で自動的に外れ、申請も
フォームもありません。
ライブプロバイダーの時間あたり制限
FANZA、DMM、自前カタログ配信のプロバイダーに時間あたりの上限はありません。リクエスト時に ソースから取得するプロバイダーは上流へ実リクエストが1本飛ぶため、時間あたりの枠を共有します：
- 1アカウントにつき毎時 6,000 件。超えると
/queryはRetry-After付きの429を返します。 - 1プロバイダーにつき毎時 3,000 コール、全ユーザー合計。混み合ったら検索から外し、残りで
応答します。
providers=でピン留めしているとフォールバックがなく、代わりにRetry-After付きの503が返ります。
普通に使ってここに届くことはまずありません。枠は記録上最も忙しい正当な1時間より十分高く、 暴走スクリプト1本で全員がソースを使えなくなるのを防ぎます。
関連する歯止めも1つ。q が空のまま50ページ目より先へ進むと 422。検索語なしで
フィルターだけを深くページングするのは検索ではなくカタログの列挙です。q を足すか、
フィルターを絞ってください。
残高が尽きたとき
API は 402 Payment Required を返し、課金はしません。Retry-After は1時間ですが、自動化
クライアント向けのヒントでロックアウトではありません。チャージすれば次の呼び出しはそのまま
通ります。
チャージはダッシュボードから。$15 以上で上乗せクレジット、 $50 以上で最大 10% の最大ボーナス。数値は支払いごとの抽選で、同段階でも変わります。
レスポンスヘッダー
X-Response-Time-Ms— 処理時間。X-Balance-Remaining— コール後の残りクレジット。X-Cache: HIT | MISS— この回答がキャッシュから返ったか。/movie、/query、/idols、 キャッシュされる探索・分析・正規化エンドポイントに付きます。ヒットは無料。X-Degraded— 回答の組み立て中に1つ以上のインデックス読み取りが失敗すると付き、値は失敗数。 回答は 無料で、キャッシュされません。Retry-After—429、402、503に付きます。従ってください。
ステータスコードの全一覧はエラーへ。