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étodo | API | Objetivo | regla de facturación | Mínimo | Máximo |
|---|---|---|---|---|---|
GET | /v1/auth/verify | Verificar la clave API | Gratis | 0 | 0 |
GET | /v1/credits | Leer saldo de crédito | Gratis | 0 | 0 |
GET | /v1/credits/costs | Leer catálogo de facturación | Gratis | 0 | 0 |
GET | /v1/rankings/chinese-low-subscriber-long-videos | Clasificación de vídeos largos chinos con pocos suscriptores | 1 por 1 a 20 artículos reales | 0 | 3 |
GET | /v1/rankings/hot-today | Clasificación de los días más calurosos | 1 por 1 a 20 artículos reales | 0 | 3 |
POST | /v1/videos/outliers/search | Búsqueda de vídeos Outlier | 2 por 1 a 20 artículos reales | 0 | 6 |
GET | /v1/videos/{video_id} | Detalle del vídeo | 1 cuando se devuelve un video | 0 | 1 |
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 devueltos | ranking chino | Caliente hoy | Búsqueda Outlier |
|---|---|---|---|
| 0 artículos | 0 | 0 | 0 |
| 1 a 20 artículos | 1 | 1 | 2 |
| 21 a 40 artículos | 2 | 2 | 4 |
| 41–50 artículos | 3 | 3 | 6 |
Tabla de créditos de herramientas MCP#
REST API y MCP utilizan la misma cuenta de crédito y reglas de liquidación.
| Herramienta MCP | Operación | Costo |
|---|---|---|
get_chinese_low_subscriber_long_videos | Clasificación de vídeos largos chinos con pocos suscriptores | 1 por 1 a 20 artículos, máximo 3 |
get_hot_today | Clasificación de los días más calurosos | 1 por 1 a 20 artículos, máximo 3 |
search_outlier_videos | Búsqueda Outlier | 2 por 1 a 20 artículos, máximo 6 |
analyze_video_url | Detalle del vídeo | 1 en éxito |
get_credit_balance | Saldo crediticio | 0 |
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ón | Objetivo | Costo |
|---|---|---|
/health/live | Comprobación de vida central API | 0 |
/health/ready | Verificación de la preparación de la base de datos y del servicio | 0 |
/v1/auth/verify | Verificar la clave API | 0 |
/v1/credits | Leer saldo de crédito | 0 |
/v1/credits/costs | Leer reglas de facturación | 0 |
| Crear, rotar o revocar una clave API | Web API Gestión de consola | 0 |
| Leer el uso y el estado de la plataforma | Web API Gestión de consola | 0 |
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.
| Caso | Costo final |
|---|---|
| Clave API no válida, sin suscripción o alcance insuficiente | 0 |
| Parámetros no válidos, recursos faltantes o créditos insuficientes | 0 |
| Se superó el límite de tasa o simultaneidad | 0 |
| Error de servicio o datos no disponibles | Los créditos reservados se reembolsan; coste final 0 |
El ranking chino ETag golpea el regreso de 304 | 0 |
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 idempotencia | Tratada y facturada como una nueva solicitud. |
| MCP repite la misma clave, herramienta y argumentos normalizados en 30 segundos | Reutiliza 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.