개발자 크레딧

유료 사용자는 매월 1,000크레딧을 받습니다. 크레딧은 이월되지 않습니다.

월별 보조금#

유료 사용자는 매월 1,000크레딧을 받습니다. 크레딧은 이월되지 않습니다.

분기별 및 반년 구독에도 한 번에 한 달에 한 번씩 1,000크레딧이 제공됩니다.

운영 비용#

순위는 실제 20개 항목당 1크레딧이 필요합니다. outlier 검색 비용은 2입니다. 발견된 비디오 세부 비용은 1입니다. 비용이 0인지 확인하고 잔액을 조정합니다.

예약 및 정산#

서버는 all_data.items.length 및 filter_data.items.length 중 더 큰 것을 사용하여 검증하고 최대 비용을 예약하고 실행하고 정산합니다. 두 세트는 청구를 위해 함께 추가되지 않습니다. 차액은 원자적으로 환불됩니다.

제로 비용 대응#

빈 결과, 찾을 수 없음, 304, 잘못된 요청, 인증 오류, 비율 제한 및 서버 오류 비용은 0입니다.

REST API 신용 테이블을 완성하세요#

이는 모든 공개 개발자 플랫폼 V1 REST 엔드포인트에 대한 현재 청구 규칙입니다. 순위 및 검색 엔드포인트는 all_data 및 filter_data의 더 큰 실제 항목 수를 사용하여 한 번 정산됩니다. 두 개의 개수는 추가되지 않으며 청구에서는 요청된 limit를 직접 사용하지 않습니다.

방법	API	목적	청구 규칙	최고
`GET`	`/v1/auth/verify`	API 키 확인	무료	0
`GET`	`/v1/credits`	크레딧 잔액 읽기	무료	0
`GET`	`/v1/credits/costs`	청구 카탈로그 읽기	무료	0
`GET`	`/v1/rankings/chinese-low-subscriber-long-videos`	중국 저구독자 장편영상 순위	실제 항목 1~20개당 1개	3
`GET`	`/v1/rankings/hot-today`	요즘 핫한 순위	실제 항목 1~20개당 1개	3
`POST`	`/v1/videos/outliers/search`	Outlier 비디오 검색	실제 항목 1~20개당 2개	6
`GET`	`/v1/videos/{video_id}`	영상 세부정보	1 하나의 동영상이 반환되는 경우	1

limit의 기본값은 20이며 최소 1개, 최대 50개입니다. 실제 항목 수는 max(all_data.items.length, filter_data.items.length)입니다. 중국 및 인기 순위는 ceil(actual items ÷ 20) × 1를 사용합니다. outlier 검색은 ceil(actual items ÷ 20) × 2를 사용합니다.

예를 들어 limit=50가 3개의 중국 순위 항목만 반환하는 경우 최종 비용은 1입니다. outlier 검색이 3을 반환하면 비용은 2입니다. 최대값이 먼저 예약된 다음 실제 결과가 확정되고 차액이 원자적으로 환불됩니다.

실제 상품이 반환되었습니다.	중국 순위	오늘은 덥다	Outlier 검색
0개 항목	0	0	0
1~20개 항목	1	1	2
21~40개 항목	2	2	4
41~50개 항목	3	3	6

MCP 도구 크레딧 테이블#

REST API 및 MCP는 동일한 신용 계정 및 결제 규칙을 사용합니다.

MCP 도구	작업	비용
`get_chinese_low_subscriber_long_videos`	중국 저구독자 장편영상 순위	1~20개 항목당 1개, 최대 3개
`get_hot_today`	요즘 핫한 순위	1~20개 항목당 1개, 최대 3개
`search_outlier_videos`	Outlier 검색	1~20개 항목당 2개, 최대 6개
`analyze_video_url`	영상 세부정보	성공 시 1개
`get_credit_balance`	신용 잔액	0

크레딧 비용이 들지 않는 상태 및 관리 요청#

웹 콘솔의 상태 확인, 청구 조회 및 키 관리에는 개발자 크레딧이 사용되지 않습니다. /control/v1/*는 ShortsMonkey 웹사이트와 Core API 사이의 서명된 내부 인터페이스이며 일반 개발자가 직접 호출해서는 안 됩니다.

엔드포인트 또는 작업	목적	비용
`/health/live`	코어 API 활성 확인	0
`/health/ready`	데이터베이스 및 서비스 준비 상태 확인	0
`/v1/auth/verify`	API 키 확인	0
`/v1/credits`	크레딧 잔액 읽기	0
`/v1/credits/costs`	청구 규칙 읽기	0
API 키 생성, 회전 또는 취소	웹 API 콘솔 관리	0
사용량 및 플랫폼 상태 읽기	웹 API 콘솔 관리	0

비용 없음, 환불 및 중복 요청 규칙#

캐시 적중은 자동으로 무료가 아닙니다. Hot Today는 서버 캐시가 사용될 때 실제 반환된 항목에 따라 요금이 청구됩니다. 아래의 경우만 0으로 정정됩니다.

사례	최종 비용
잘못된 API 키, 구독 없음 또는 범위 부족	0
잘못된 매개변수, 누락된 리소스 또는 부족한 크레딧	0
속도 또는 동시성 한도가 초과되었습니다.	0
서비스 오류 또는 사용할 수 없는 데이터	예약된 크레딧은 환불됩니다. 최종 비용 0
중국 랭킹 `ETag` 히트 복귀 `304`	0
동일한 `Idempotency-Key` 및 매개변수를 사용하여 재시도하세요.	추가 비용 없이 원래 응답을 반환합니다.
멱등성 키를 재사용하지 않고 동일한 요청	새로운 요청으로 처리되어 비용이 청구됩니다.
MCP는 30초 이내에 동일한 키, 도구 및 정규화된 인수를 반복합니다.	추가 비용 없이 원래 결과를 재사용합니다.

응답에서 청구 내용을 읽어보세요.#

모든 성공적인 공개 API 응답은 X-Credits-Cost, X-Credits-Remaining 및 X-Credits-Period-End를 통해 현재 비용, 남은 잔액 및 신용 기간 종료를 반환합니다.

JSON 필드 credits.cost, credits.remaining 및 credits.period_ends_at는 동일한 정보를 제공합니다. 응답의 실제 cost를 사용하세요.