Files
cc-switch/docs/user-manual/ja/4-proxy/4.4-usage.md
Jason b1f9ce4653 feat(deepseek): switch presets to V4 (flash/pro) and add pricing
DeepSeek released V4 flash/pro; legacy IDs deepseek-chat / deepseek-reasoner
now alias to deepseek-v4-flash and will be deprecated.

- Update claude/hermes/opencode/openclaw presets to v4-pro / v4-flash,
  context 128K -> 1M; Claude Anthropic-compat endpoint routes OPUS/SONNET
  to v4-pro and HAIKU to v4-flash, plus an explicit modelsUrl override.
- Seed deepseek-v4-flash ($0.14/$0.28 per 1M) and deepseek-v4-pro
  ($1.68/$3.36 per 1M) into model_pricing; older v3.x / chat / reasoner
  rows kept for historical usage stats (INSERT OR IGNORE).
- Refresh user-manual (zh/en/ja) pricing table and note that legacy model
  IDs are billed at v4-flash rates.
2026-04-24 23:24:37 +08:00

12 KiB
Raw Permalink Blame History

4.4 使用量統計

機能説明

使用量統計機能は、API リクエストデータを記録・分析して、以下をサポートします:

  • API の使用状況の把握
  • 費用支出の見積もり
  • 使用パターンの分析
  • 問題のトラブルシューティング

v3.13.0 より、使用量データの取得元は 2 つあります:

データ取得元 対象範囲 プロキシ経由が必要?
プロキシリクエストログ プロキシを経由したすべてのリクエスト 必要
CLI セッションログv3.13 新規) Claude / Codex / Gemini のセッション履歴 不要
  • Codex セッションJSONL セッションログに基づく 精密な解析 に切り替え、従来の推定値を置き換え。モデル名を正規化することで料金検索の整合性を保証
  • Gemini セッションGemini CLI のセッションログから精密に同期
  • Claude セッション:セッションログから直接使用量をインポート可能
  • 使用量パネルは アプリ別フィルタリングClaude / Codex / Geminiに対応し、データが混在しません

前提条件

使用するデータ取得元によって前提条件が異なります:

プロキシリクエストログ(すべてのアプリとプロキシリクエストを対象):

  1. プロキシサービスを起動
  2. アプリケーション接管を有効化
  3. ログ記録を有効化

CLI セッションログv3.13 新規、プロキシ不要):

  1. CC Switch で対応するアプリClaude / Codex / Geminiを有効化
  2. 対応する CLI にセッション履歴ファイルがあること
  3. CC Switch が定期的にセッションディレクトリをスキャンして使用量をインポートします

使用量統計を開く

設定 → 使用量 タブ

統計概要

集計カード

ページ上部に主要指標が表示されます:

指標 説明
総リクエスト数 統計期間内のリクエスト総数
総 Token 入力 + 出力 Token の合計
推定費用 料金設定に基づいて計算された費用
成功率 成功したリクエストの割合

期間

統計の期間を選択できます:

オプション 範囲
今日 当日 00:00 から現在まで
過去 7 日間 直近 7 日間
過去 30 日間 直近 30 日間

image-20260108011730105

トレンドグラフ

リクエストトレンド

折れ線グラフでリクエスト数の変化傾向を表示:

  • X 軸:時間
  • Y 軸:リクエスト数
  • 時間単位/日単位で表示可能
  • ズームとドラッグに対応

Token トレンド

Token 使用量の変化を表示:

  • 入力 Token- ユーザーが送信した prompt の内容
  • 出力 Token- AI が生成した回答の内容
  • キャッシュ作成 Tokenオレンジ- 初回キャッシュ作成で消費された Token
  • キャッシュヒット Token- キャッシュ再利用で節約された Token
  • コスト(赤い破線、右側 Y 軸)- 推定費用

キャッシュ Token の説明Anthropic API は Prompt Caching 機能をサポートしています。キャッシュ作成時は高い料金(通常、入力価格の 1.25 倍)がかかりますが、その後のキャッシュヒット時は 0.1 倍の価格のみで、繰り返しリクエストのコストを大幅に削減できます。

時間粒度

  • 今日時間単位で表示24 データポイント)
  • 7 日間/30 日間:日単位で表示

image-20260108011742847

詳細データ

ページ下部に 3 つのデータタブがあります:

リクエストログ

各リクエストの詳細記録:

フィールド 説明
時間 リクエスト時刻
プロバイダー 使用されたプロバイダー名
モデル リクエストされたモデル(課金モデル)
入力 Token 入力の Token 数
出力 Token 出力の Token 数
キャッシュ読取 キャッシュヒットの Token 数
キャッシュ作成 キャッシュ作成の Token 数
総費用 推定費用(ドル)
所要時間情報 リクエスト時間、初回 Token 時間、ストリーム/非ストリーム
ステータス HTTP ステータスコード

所要時間情報の説明

所要時間情報列には複数のバッジが表示されます:

バッジ 説明 色のルール
総所要時間 リクエストの総時間(秒) ≤5s 緑、≤120s オレンジ、>120s 赤
初回 Token ストリームリクエストの最初の Token 時間 ≤5s 緑、≤120s オレンジ、>120s 赤
ストリーム/非ストリーム リクエストタイプ ストリーム:青、非ストリーム:紫

詳細の表示

リクエスト行をクリックすると詳細情報を表示:

  • 完全なリクエストパラメータ
  • レスポンス内容のサマリー
  • エラー情報(失敗した場合)

ログのフィルタリング

以下の条件でフィルタリングできます:

フィルタ項目 オプション
アプリタイプ すべて / Claude / Codex / Gemini
ステータスコード すべて / 200 / 400 / 401 / 429 / 500
プロバイダー テキスト検索
モデル テキスト検索
期間 開始時刻 - 終了時刻(日時ピッカー)

操作ボタン:

  • 検索:フィルタ条件を適用
  • リセット:デフォルトに戻す(過去 24 時間)
  • 更新:データを再読み込み

image-20260108011859974

プロバイダー統計

プロバイダー別の集計データ:

フィールド 説明
プロバイダー プロバイダー名
リクエスト数 そのプロバイダーの総リクエスト数
成功数 成功したリクエスト数
失敗数 失敗したリクエスト数
成功率 成功の割合
総 Token Token 使用量の合計
推定費用 そのプロバイダーの費用

image-20260108011907928

モデル統計

モデル別の集計データ:

フィールド 説明
モデル モデル名
リクエスト数 そのモデルの総リクエスト数
入力 Token 入力 Token の合計
出力 Token 出力 Token の合計
平均レイテンシ 平均応答時間
推定費用 そのモデルの費用

image-20260108011915381

料金設定

料金設定を開く

設定 → 詳細 → 料金設定

モデル価格の設定

各モデルの価格を設定100 万 Token あたり):

フィールド 説明
モデル ID モデル識別子claude-3-sonnet
表示名 カスタム表示名
入力価格 100 万入力 Token あたりの価格
出力価格 100 万出力 Token あたりの価格
キャッシュ読取価格 100 万キャッシュヒット Token あたりの価格
キャッシュ作成価格 100 万キャッシュ作成 Token あたりの価格

モデル ID の正規化ルール

料金を照合する前に、CC Switch はリクエスト内のモデル ID を正規化します:

  • 最後の / より前の接頭辞を削除
  • : 以降の接尾辞を削除
  • @- に置換

料金設定では、リクエスト内の完全な元のモデル名ではなく、正規化後のモデル ID を入力してください。

元のモデル名 入力するモデル ID 説明
stepfun-ai/step-3.5-flash step-3.5-flash プロバイダー接頭辞を削除
moonshotai/kimi-k2-0905:exa kimi-k2-0905 接頭辞と : 以降を削除
gpt-5.2-codex@low gpt-5.2-codex-low @- に置換

操作

  • 追加:「追加」ボタンで新しいモデル価格を追加
  • 編集:行末の編集アイコンで変更
  • 削除:行末の削除アイコンで削除

image-20260108011933565

プリセット価格

CC Switch は一般的なモデルの公式価格100 万 Token あたりをプリセットしています。v3.13.0 では一部モデルの CNY → USD 価格を修正 し、これまで欠けていたモデル定義を補完したほか、MiniMax のプランクォータ計算0% → 100% の使用進捗 表示を修正し、費用見積もりとプラン進捗の表示がより正確になりました。

Claude シリーズ(ドル)

モデル 入力 出力 キャッシュ読取 キャッシュ作成
Claude 4.5 シリーズ
claude-opus-4-5 $5 $25 $0.50 $6.25
claude-sonnet-4-5 $3 $15 $0.30 $3.75
claude-haiku-4-5 $1 $5 $0.10 $1.25
Claude 4 シリーズ
claude-opus-4 $15 $75 $1.50 $18.75
claude-opus-4-1 $15 $75 $1.50 $18.75
claude-sonnet-4 $3 $15 $0.30 $3.75
Claude 3.5 シリーズ
claude-3-5-sonnet $3 $15 $0.30 $3.75
claude-3-5-haiku $0.80 $4 $0.08 $1.00

OpenAI シリーズ / Codexドル

モデル 入力 出力 キャッシュ読取
GPT-5.2 シリーズ
gpt-5.2 $1.75 $14 $0.175
GPT-5.1 シリーズ
gpt-5.1 $1.25 $10 $0.125
GPT-5 シリーズ
gpt-5 $1.25 $10 $0.125

Codex プリセットには low/medium/high などの変種が含まれており、価格はベースモデルと同一です。

Gemini シリーズ(ドル)

モデル 入力 出力 キャッシュ読取
Gemini 3 シリーズ
gemini-3-pro-preview $2 $12 $0.20
gemini-3-flash-preview $0.50 $3 $0.05
Gemini 2.5 シリーズ
gemini-2.5-pro $1.25 $10 $0.125
gemini-2.5-flash $0.30 $2.50 $0.03

中国メーカーのモデル

注: 通貨は各プロバイダーの公式料金ページに従います。StepFun は現在 USD 表記です。

DeepSeek 互換: 旧モデル名 deepseek-chat / deepseek-reasonerdeepseek-v4-flash非思考思考モードと等価になり、v4-flash 料金で課金されます。

モデル 入力 出力 キャッシュ読取
StepFun
step-3.5-flash $0.10 $0.30 $0.02
DeepSeek
deepseek-v4-flash ¥1.00 ¥2.00 ¥0.20
deepseek-v4-pro ¥12.00 ¥24.00 ¥1.00
Kimi (月之暗面)
kimi-k2-thinking ¥4.00 ¥16.00 ¥1.00
kimi-k2 ¥4.00 ¥16.00 ¥1.00
kimi-k2-turbo ¥8.00 ¥58.00 ¥1.00
MiniMax
minimax-m2.1 ¥2.10 ¥8.40 ¥0.21
minimax-m2.1-lightning ¥2.10 ¥16.80 ¥0.21
その他
glm-4.7 ¥2.00 ¥8.00 ¥0.40
doubao-seed-code ¥1.20 ¥8.00 ¥0.24
mimo-v2-flash 無料 無料 -

カスタム価格

中継サービスを使用する場合、価格が異なる場合があります:

  1. 「編集」ボタンをクリック
  2. 価格を変更
  3. 保存

よくある質問

統計データが空

確認事項:

  • プロキシサービスが実行中か
  • アプリケーション接管が有効か
  • ログ記録が有効か
  • プロキシ経由でリクエストがあったか

費用の見積もりが不正確

考えられる原因:

  • 料金設定が実際と異なる
  • 中継サービスの特別な料金体系を使用

解決方法:

  • 料金設定を更新
  • プロバイダーの実際の請求書を参照

Token 数がプロバイダーと一致しない

CC Switch は独自の方法で Token 数を推定しており、プロバイダーの計算方法と若干の差異が生じる場合があります。プロバイダーの請求書を基準にしてください。