ShortsMonkey DocumentationConsole APICréer une clé

Crédits du développeur

Les utilisateurs payants reçoivent 1 000 crédits par mois interne. Les crédits ne sont pas reportés.

Subvention mensuelle#

Les utilisateurs payants reçoivent 1 000 crédits par mois interne. Les crédits ne sont pas reportés.

Les abonnements trimestriels et semestriels reçoivent toujours 1 000 crédits un mois interne à la fois.

Coûts d'exploitation#

Les classements coûtent 1 crédit pour 20 éléments réels ; La recherche outlier coûte 2 ; les détails vidéo trouvés coûtent 1 ; vérifier et équilibrer le coût 0.

Réserver et régler#

Le serveur valide, réserve le coût maximum, exécute et règle une fois en utilisant le plus grand de all_data.items.length et filter_data.items.length ; les deux ensembles ne sont jamais additionnés pour la facturation. La différence est remboursée atomiquement.

Des réponses à coût nul#

Les résultats vides, introuvables, 304, requêtes invalides, erreurs d'authentification, limites de débit et erreurs de serveur coûtent 0.

Tableau de crédit complet REST API#

Il s’agit des règles de facturation actuelles pour chaque point de terminaison REST public Developer Platform V1. Les points de terminaison de classement et de recherche sont réglés une fois en utilisant le nombre d'éléments réels le plus élevé de all_data et filter_data ; les deux comptes ne sont pas additionnés et la facturation n'utilise pas directement le limit demandé.

MéthodeAPIButRègle de facturationMinimumMaximum
GET/v1/auth/verifyVérifier la clé APIGratuit00
GET/v1/creditsLire le solde créditeurGratuit00
GET/v1/credits/costsLire le catalogue de facturationGratuit00
GET/v1/rankings/chinese-low-subscriber-long-videosClassement chinois des vidéos longues à faible abonnement1 pour 1 à 20 éléments réels03
GET/v1/rankings/hot-todayClassement chaud aujourd'hui1 pour 1 à 20 éléments réels03
POST/v1/videos/outliers/searchRecherche vidéo Outlier2 pour 1 à 20 éléments réels06
GET/v1/videos/{video_id}Détail vidéo1 lorsqu'une vidéo est renvoyée01

Règlement par nombre d'articles réel#

La valeur par défaut de limit est 20, avec un minimum de 1 et un maximum de 50. Le nombre d'éléments réel est max(all_data.items.length, filter_data.items.length). Les classements chinois et chauds d'aujourd'hui utilisent ceil(actual items ÷ 20) × 1 ; La recherche outlier utilise ceil(actual items ÷ 20) × 2.

Par exemple, si limit=50 renvoie uniquement 3 éléments de classement chinois, le coût final est de 1 ; si la recherche outlier renvoie 3, le coût est de 2. Le maximum est réservé en premier, puis le résultat réel est réglé et la différence remboursée de manière atomique.

Articles réels retournésClassement chinoisChaud aujourd'huiRecherche Outlier
0 articles000
1 à 20 articles112
21 à 40 articles224
41 à 50 articles336

Tableau de crédit des outils MCP#

REST API et MCP utilisent les mêmes règles de compte de crédit et de règlement.

Outil MCPOpérationCoût
get_chinese_low_subscriber_long_videosClassement chinois des vidéos longues à faible abonnement1 pour 1 à 20 articles, maximum 3
get_hot_todayClassement chaud aujourd'hui1 pour 1 à 20 articles, maximum 3
search_outlier_videosRecherche Outlier2 pour 1 à 20 articles, maximum 6
analyze_video_urlDétail vidéo1 sur le succès
get_credit_balanceSolde créditeur0

Des demandes de statut et de gestion qui ne coûtent aucun crédit#

Les vérifications de l'état, les recherches de facturation et la gestion des clés dans la console Web ne consomment pas de crédits de développeur. /control/v1/* est une interface interne signée entre le site Web ShortsMonkey et Core API et ne doit pas être appelée directement par les développeurs réguliers.

Point de terminaison ou opérationButCoût
/health/liveVérification de l'activité du noyau API0
/health/readyVérification de l'état de préparation de la base de données et des services0
/v1/auth/verifyVérifier la clé API0
/v1/creditsLire le solde créditeur0
/v1/credits/costsLire les règles de facturation0
Créer, faire pivoter ou révoquer une clé APIGestion de la console Web API0
Lire l'utilisation et l'état de la plateformeGestion de la console Web API0

Règles de coût nul, de remboursement et de demande en double#

Un accès au cache n'est pas automatiquement gratuit : les éléments chauds d'aujourd'hui sont toujours facturés en fonction des éléments réellement retournés lorsque le cache du serveur est utilisé. Seuls les cas ci-dessous s'établissent à 0.

CasCoût final
Clé API non valide, pas d'abonnement ou portée insuffisante0
Paramètres invalides, ressource manquante ou crédits insuffisants0
Limite de débit ou de simultanéité dépassée0
Erreur de service ou données indisponiblesLes crédits réservés sont remboursés ; coût final 0
Le classement chinois ETag frappe le retour de 3040
Réessayez avec les mêmes Idempotency-Key et paramètresRenvoie la réponse originale sans frais supplémentaires
Même requête sans réutiliser la clé d'idempotenceTraité et facturé comme une nouvelle demande
MCP répète la même clé, le même outil et les mêmes arguments normalisés dans les 30 secondesRéutilise le résultat original sans frais supplémentaires

Lisez l'accusation dans la réponse#

Chaque réponse publique API réussie renvoie le coût actuel, le solde restant et la fin de la période de crédit via X-Credits-Cost, X-Credits-Remaining et X-Credits-Period-End.

Les champs JSON credits.cost, credits.remaining et credits.period_ends_at fournissent les mêmes informations. Utilisez le cost réel de la réponse.