開発者クレジット
有料ユーザーは社内月あたり 1,000 クレジットを受け取ります。クレジットは繰り越されません。
毎月の助成金#
有料ユーザーは社内月あたり 1,000 クレジットを受け取ります。クレジットは繰り越されません。
四半期および半年のサブスクリプションでも、社内月に一度に 1,000 クレジットを受け取ります。
運用コスト#
ランキングには実際の 20 アイテムごとに 1 クレジットがかかります。 outlier 検索のコストは 2。ビデオの詳細コスト 1 が見つかりました。コスト 0 を確認してバランスを取ります。
予約して決済する#
サーバーは、all_data.items.length と filter_data.items.length の大きい方を使用して検証し、最大コストを予約し、実行し、一度決済します。 2 つのセットが合計されて請求されることはありません。差額はアトミックに返金されます。
コストゼロの対応#
空の結果、見つからない、304、無効なリクエスト、認証エラー、レート制限、およびサーバー エラーのコストは 0 です。
完全な REST API クレジット テーブル#
これらは、すべてのパブリック Developer Platform V1 REST エンドポイントの現在の請求ルールです。ランキングおよび検索エンドポイントは、all_data および filter_data からのより大きな実際のアイテム数を使用して一度解決されます。 2 つのカウントは加算されず、請求では要求された limit が直接使用されません。
| 方法 | API | 目的 | 請求ルール | 最小 | 最大 |
|---|---|---|---|---|---|
GET | /v1/auth/verify | API キーを確認します | 無料 | 0 | 0 |
GET | /v1/credits | クレジット残高の読み取り | 無料 | 0 | 0 |
GET | /v1/credits/costs | 請求カタログを読む | 無料 | 0 | 0 |
GET | /v1/rankings/chinese-low-subscriber-long-videos | 中国の低チャンネル登録者の長編動画ランキング | 実際のアイテム 1 ~ 20 個につき 1 個 | 0 | 3 |
GET | /v1/rankings/hot-today | 今日の注目ランキング | 実際のアイテム 1 ~ 20 個につき 1 個 | 0 | 3 |
POST | /v1/videos/outliers/search | Outlier ビデオ検索 | 実際のアイテム 1 ~ 20 個につき 2 個 | 0 | 6 |
GET | /v1/videos/{video_id} | ビデオの詳細 | 1 つのビデオが返された場合 | 0 | 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 |
クレジットを必要としないステータスおよび管理リクエスト#
Web コンソールでのヘルスチェック、請求情報の検索、およびキー管理では、開発者クレジットは消費されません。 /control/v1/* は、ShortsMonkey Web サイトとコア API の間の署名された内部インターフェイスであり、通常の開発者が直接呼び出すことはできません。
| エンドポイントまたはオペレーション | 目的 | 料金 |
|---|---|---|
/health/live | コア API 活性チェック | 0 |
/health/ready | データベースとサービスの準備状況のチェック | 0 |
/v1/auth/verify | API キーを確認します | 0 |
/v1/credits | クレジット残高の読み取り | 0 |
/v1/credits/costs | 請求ルールを読む | 0 |
| API キーの作成、回転、または取り消し | Web API コンソール管理 | 0 |
| 使用状況とプラットフォームのステータスを読み取る | Web 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 を使用します。