속도 제한 및 요금
호출 하나의 비용, 보낼 수 있는 속도, 크레딧이 떨어지면 벌어지는 일.
호출 비용
답변에만 지불합니다: 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는 공개 카탈로그 카운터(통계)로,
키도 요금도 없습니다. /resolve/batch는 최대 100개 코드를 받고 시작된 고유 코드 10개마다 한
그룹으로 청구합니다.
새 계정에는 $0.02의 무료 크레딧, 검색 약 50회 분량이 있습니다. 작은 것 하나 만들기에 충분합니다.
페이지가 크면 더 비쌉니다
/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 다섯 번과 num=50 한 번은 같은 비용입니다. 페이지 크기는 편의 장치이지 할인이
아닙니다.
같은 공식이 /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을 넘기세요.
결과는 같고 호출당 가격은 두 배입니다.
결과 없음은 오류가 아닙니다
/query가 아무것도 찾지 못하면 count: 0과 빈 results 배열이 담긴 200을 받습니다.
무료입니다. count를 확인하세요.
미리보기 전송
미리보기 클립은 cdn.javinfo.dev에서 제공되며 호출 횟수가 아니라 데이터량으로 청구됩니다.
GB당 $0.30, 소스에서 처음 가져올 때만 부과됩니다. 이후에는 자체 오브젝트 스토리지에 저장되어
누구에게나 무료입니다.
화질은 계정 상태를 따릅니다. 충전하면 해당 작품의 최상 버전, 그 전에는 표준입니다.
영상 URL은 계정에 묶여 있고 만료되지 않습니다. 작년 링크도 그대로 재생됩니다. 다만 링크를 받은 사람은 여러분의 잔액으로 스트리밍합니다. 미리보기 URL은 API 키만큼 조심하세요.
얼마나 자주 호출할 수 있나
제한은 계정별로, 모든 키가 함께 씁니다.
| 계정 상태 | 분당 요청 수 |
|---|---|
| 첫 충전 전 | 10 |
| 첫 충전 후 | 60 |
초과하면 Retry-After와 함께 429가 반환됩니다. 첫 결제가 처리되면 제한은 알아서 풀리며
신청은 없습니다.
실시간 제공업체의 시간당 제한
FANZA, DMM과 자체 카탈로그 제공업체는 시간당 제한이 없습니다. 요청 시점에 소스에서 가져오는 제공업체는 실제 상위 요청이 발생해 시간당 예산을 공유합니다:
- 계정당 시간당 결과 6,000개. 초과하면
/query가Retry-After와 함께429를 반환합니다. - 전체 사용자 합산, 제공업체당 시간당 호출 3,000회. 한 곳이 붐비면 검색에서 빼고 나머지로
응답합니다.
providers=로 고정했다면 넘어갈 곳이 없어503과Retry-After를 받습니다.
평범하게 쓰면 근처에도 가지 않습니다. 계정 예산은 기록된 가장 바쁜 정상 시간대보다 훨씬 높습니다. 폭주 스크립트 하나로 모두가 소스를 못 쓰게 되는 일을 막습니다.
관련 안전장치도 있습니다. q가 빈 채 50페이지를 넘어가면 422가 반환됩니다. 검색어 없이
필터만으로 깊게 넘기는 건 검색이 아니라 카탈로그 긁기입니다. q를 넣거나 필터를 좁히세요.
잔액이 떨어지면
API는 402 Payment Required를 반환하고 아무것도 청구하지 않습니다. Retry-After는 한
시간이지만 자동화 클라이언트용 힌트일 뿐, 차단이 아닙니다. 충전하면 다음 호출부터
통과합니다.
충전은 대시보드에서. $15 이상이면 보너스 크레딧, $50 이상이면 최대 10%의 가장 큰 보너스입니다. 정확한 비율은 결제마다 무작위로 정해져 같은 구간에서도 달라집니다.
응답 헤더
X-Response-Time-Ms— 처리에 걸린 시간.X-Balance-Remaining— 호출 후 남은 크레딧.X-Cache: HIT | MISS— 캐시 응답 여부./movie,/query,/idols및 캐시되는 탐색, 분석, resolve 엔드포인트에 있습니다. 적중은 무료입니다.X-Degraded— 답변 조립 중 인덱스 읽기 실패 시 있으며, 값은 실패 수입니다. 답변은 무료 제공, 캐시 없음.Retry-After—429,402,503에 포함됩니다. 지키세요.
전체 상태 코드는 오류를 참조하세요.