ShortsMonkey DocumentaciónConsola APICrear clave

Créditos de desarrollador

Los usuarios pagos reciben 1000 créditos por mes interno. Los créditos no se acumulan.

Subvención mensual#

Los usuarios pagos reciben 1000 créditos por mes interno. Los créditos no se acumulan.

Las suscripciones trimestrales y semestrales aún reciben 1000 créditos por mes interno a la vez.

Costos de operación#

Las clasificaciones cuestan 1 crédito por cada 20 elementos reales; La búsqueda outlier cuesta 2; el detalle del video encontrado cuesta 1; verificar y equilibrar costo 0.

Reservar y liquidar#

El servidor valida, reserva el costo máximo, ejecuta y liquida una vez usando el mayor de all_data.items.length y filter_data.items.length; los dos conjuntos nunca se suman para la facturación. La diferencia se reembolsa de forma atómica.

Respuestas sin costo#

Los resultados vacíos, no encontrados, 304, solicitudes no válidas, errores de autenticación, límites de velocidad y errores del servidor cuestan 0.

Tabla de créditos completa REST API#

Estas son las reglas de facturación actuales para cada punto final REST de la plataforma de desarrollador V1 pública. Los puntos finales de clasificación y búsqueda se establecen una vez utilizando el mayor recuento de elementos reales de all_data y filter_data; los dos recuentos no se suman y la facturación no utiliza directamente el limit solicitado.

MétodoAPIObjetivoregla de facturaciónMínimoMáximo
GET/v1/auth/verifyVerificar la clave APIGratis00
GET/v1/creditsLeer saldo de créditoGratis00
GET/v1/credits/costsLeer catálogo de facturaciónGratis00
GET/v1/rankings/chinese-low-subscriber-long-videosClasificación de vídeos largos chinos con pocos suscriptores1 por 1 a 20 artículos reales03
GET/v1/rankings/hot-todayClasificación de los días más calurosos1 por 1 a 20 artículos reales03
POST/v1/videos/outliers/searchBúsqueda de vídeos Outlier2 por 1 a 20 artículos reales06
GET/v1/videos/{video_id}Detalle del vídeo1 cuando se devuelve un video01

Liquidación por recuento de artículos reales#

limit tiene un valor predeterminado de 20, con un mínimo de 1 y un máximo de 50. El recuento de artículos real es max(all_data.items.length, filter_data.items.length). Las clasificaciones chinas y de actualidad utilizan ceil(actual items ÷ 20) × 1; La búsqueda outlier utiliza ceil(actual items ÷ 20) × 2.

Por ejemplo, si limit=50 devuelve solo 3 elementos de clasificación chinos, el costo final es 1; si la búsqueda outlier devuelve 3, el costo es 2. Primero se reserva el máximo, luego se liquida el resultado real y se reembolsa la diferencia de forma atómica.

Artículos reales devueltosranking chinoCaliente hoyBúsqueda Outlier
0 artículos000
1 a 20 artículos112
21 a 40 artículos224
41–50 artículos336

Tabla de créditos de herramientas MCP#

REST API y MCP utilizan la misma cuenta de crédito y reglas de liquidación.

Herramienta MCPOperaciónCosto
get_chinese_low_subscriber_long_videosClasificación de vídeos largos chinos con pocos suscriptores1 por 1 a 20 artículos, máximo 3
get_hot_todayClasificación de los días más calurosos1 por 1 a 20 artículos, máximo 3
search_outlier_videosBúsqueda Outlier2 por 1 a 20 artículos, máximo 6
analyze_video_urlDetalle del vídeo1 en éxito
get_credit_balanceSaldo crediticio0

Solicitudes de estado y gestión que no cuestan créditos#

Las comprobaciones de estado, las búsquedas de facturación y la administración de claves en la consola web no consumen créditos de desarrollador. /control/v1/* es una interfaz interna firmada entre el sitio web ShortsMonkey y Core API y los desarrolladores habituales no deben llamarla directamente.

Punto final u operaciónObjetivoCosto
/health/liveComprobación de vida central API0
/health/readyVerificación de la preparación de la base de datos y del servicio0
/v1/auth/verifyVerificar la clave API0
/v1/creditsLeer saldo de crédito0
/v1/credits/costsLeer reglas de facturación0
Crear, rotar o revocar una clave APIWeb API Gestión de consola0
Leer el uso y el estado de la plataformaWeb API Gestión de consola0

Reglas de costo cero, reembolso y solicitud de duplicados#

Un acierto en caché no es gratuito automáticamente: el hot hoy todavía se factura según los elementos devueltos reales cuando se utiliza el caché del servidor. Sólo los casos siguientes se resuelven en 0.

CasoCosto final
Clave API no válida, sin suscripción o alcance insuficiente0
Parámetros no válidos, recursos faltantes o créditos insuficientes0
Se superó el límite de tasa o simultaneidad0
Error de servicio o datos no disponiblesLos créditos reservados se reembolsan; coste final 0
El ranking chino ETag golpea el regreso de 3040
Vuelva a intentarlo con el mismo Idempotency-Key y parámetros.Devuelve la respuesta original sin otro cargo
Misma solicitud sin reutilizar la clave de idempotenciaTratada y facturada como una nueva solicitud.
MCP repite la misma clave, herramienta y argumentos normalizados en 30 segundosReutiliza el resultado original sin otro cargo

Lea el cargo en la respuesta.#

Cada respuesta pública exitosa de API devuelve el costo actual, el saldo restante y el final del período de crédito hasta X-Credits-Cost, X-Credits-Remaining y X-Credits-Period-End.

Los campos JSON credits.cost, credits.remaining y credits.period_ends_at proporcionan la misma información. Utilice el cost real de la respuesta.