Entwickler-Credits
Bezahlte Nutzer erhalten pro internem Monat 1.000 Credits. Sie werden nicht übertragen.
Monatliche Gutschrift#
Bezahlte Nutzer erhalten pro internem Monat 1.000 Credits. Sie werden nicht übertragen.
Auch Quartals- und Halbjahresabonnements erhalten 1.000 Credits jeweils pro internem Monat.
Operationskosten#
Rankings kosten 1 Credit je 20 tatsächlich gelieferte Einträge, die Outlier-Suche 2, ein gefundenes Videodetail 1; Prüfung und Guthabenabfrage kosten 0.
Reservieren und abrechnen#
Der Server validiert, reserviert die Maximalkosten, führt die Anfrage aus und rechnet einmal anhand des größeren Werts von all_data.items.length und filter_data.items.length ab; beide Mengen werden nie addiert. Die Differenz wird atomar erstattet.
Kostenfreie Antworten#
Leere Ergebnisse, nicht gefundene Ressourcen, 304, ungültige Anfragen, Authentifizierungsfehler, Limits und Serverfehler kosten 0 Credits.
Vollständige REST-API-Kostentabelle#
Dies sind die aktuellen Abrechnungsregeln für alle öffentlichen REST-Endpunkte der Developer Platform V1. Ranking- und Suchendpunkte werden einmal anhand der größeren tatsächlichen Anzahl aus all_data und filter_data abgerechnet; beide Mengen werden nicht addiert und das angeforderte limit wird nicht direkt berechnet.
| Methode | API | Zweck | Abrechnung | Minimum | Maximum |
|---|---|---|---|---|---|
GET | /v1/auth/verify | API-Schlüssel prüfen | Kostenlos | 0 | 0 |
GET | /v1/credits | Credit-Guthaben lesen | Kostenlos | 0 | 0 |
GET | /v1/credits/costs | Kostentabelle lesen | Kostenlos | 0 | 0 |
GET | /v1/rankings/chinese-low-subscriber-long-videos | Chinesisches Long-Video-Ranking | 1 je 1–20 tatsächliche Einträge | 0 | 3 |
GET | /v1/rankings/hot-today | Hot-Today-Ranking | 1 je 1–20 tatsächliche Einträge | 0 | 3 |
POST | /v1/videos/outliers/search | Outlier-Videosuche | 2 je 1–20 tatsächliche Einträge | 0 | 6 |
GET | /v1/videos/{video_id} | Videodetails | 1 bei einem gefundenen Video | 0 | 1 |
Abrechnung nach tatsächlicher Anzahl#
limit ist standardmäßig 20, mindestens 1 und höchstens 50. Die tatsächliche Anzahl ist max(all_data.items.length, filter_data.items.length). Chinesisches und Hot-Today-Ranking verwenden ceil(tatsächliche Einträge ÷ 20) × 1, die Outlier-Suche ceil(tatsächliche Einträge ÷ 20) × 2.
Liefert limit=50 nur 3 chinesische Ranking-Einträge, betragen die Endkosten 1; bei 3 Outlier-Ergebnissen sind es 2. Zuerst wird der Höchstbetrag reserviert, danach das Ergebnis abgerechnet und die Differenz atomar erstattet.
| Tatsächlich geliefert | Chinesisches Ranking | Heute beliebt | Outlier-Suche |
|---|---|---|---|
| 0 Einträge | 0 | 0 | 0 |
| 1–20 Einträge | 1 | 1 | 2 |
| 21–40 Einträge | 2 | 2 | 4 |
| 41–50 Einträge | 3 | 3 | 6 |
MCP-Tool-Kostentabelle#
REST API und MCP verwenden dasselbe Credit-Konto und dieselben Abrechnungsregeln.
| MCP-Tool | Funktion | Kosten |
|---|---|---|
get_chinese_low_subscriber_long_videos | Chinesisches Long-Video-Ranking | 1 je 1–20 Einträge, maximal 3 |
get_hot_today | Hot-Today-Ranking | 1 je 1–20 Einträge, maximal 3 |
search_outlier_videos | Outlier-Suche | 2 je 1–20 Einträge, maximal 6 |
analyze_video_url | Videodetails | 1 bei Erfolg |
get_credit_balance | Credit-Guthaben | 0 |
Kostenfreie Status- und Verwaltungsanfragen#
Health Checks, Kostenabfragen und die Schlüsselverwaltung in der Webkonsole verbrauchen keine Developer Credits. /control/v1/* ist eine signierte interne Schnittstelle zwischen der ShortsMonkey-Website und der Core API und darf nicht direkt aufgerufen werden.
| Endpunkt oder Funktion | Zweck | Kosten |
|---|---|---|
/health/live | Verfügbarkeitsprüfung der Core API | 0 |
/health/ready | Bereitschaftsprüfung für Datenbank und Dienst | 0 |
/v1/auth/verify | API-Schlüssel prüfen | 0 |
/v1/credits | Credit-Guthaben lesen | 0 |
/v1/credits/costs | Abrechnungsregeln lesen | 0 |
| API-Schlüssel erstellen, rotieren oder widerrufen | Verwaltung in der Web-API-Konsole | 0 |
| Nutzung und Plattformstatus lesen | Verwaltung in der Web-API-Konsole | 0 |
Regeln für Nullkosten, Erstattungen und Duplikate#
Ein Cache-Treffer ist nicht automatisch kostenlos: Auch bei einem Server-Cache-Treffer wird „Heute beliebt“ nach den tatsächlich gelieferten Einträgen abgerechnet. Nur die folgenden Fälle enden bei 0.
| Fall | Endkosten |
|---|---|
| Ungültiger API-Schlüssel, kein Abonnement oder fehlende Berechtigung | 0 |
| Ungültige Parameter, fehlende Ressource oder unzureichende Credits | 0 |
| Rate- oder Parallelitätslimit überschritten | 0 |
| Dienstfehler oder nicht verfügbare Daten | Reservierte Credits werden erstattet; Endkosten 0 |
ETag-Treffer des chinesischen Rankings mit 304 | 0 |
Wiederholung mit demselben Idempotency-Key und denselben Parametern | Ursprüngliche Antwort ohne erneute Belastung |
| Gleiche Anfrage ohne Wiederverwendung des Idempotenzschlüssels | Wird als neue Anfrage abgerechnet |
| MCP wiederholt Schlüssel, Tool und normalisierte Argumente innerhalb von 30 Sekunden | Ursprüngliches Ergebnis ohne erneute Belastung |
Kosten in der Antwort ablesen#
Jede erfolgreiche öffentliche API-Antwort liefert Kosten, Restguthaben und Periodenende über X-Credits-Cost, X-Credits-Remaining und X-Credits-Period-End.
Die JSON-Felder credits.cost, credits.remaining und credits.period_ends_at liefern dieselben Informationen. Verwende die tatsächlichen cost der Antwort.