オープン API · 読み取り専用

API キーの使用量と有効期限をプログラムで照会

ダッシュボードで読み取り専用トークンを発行し、1 コマンドで全アクティブ API キーの有効期限・日次使用量・クォータを照会。自分のスクリプトやダッシュボード、アラートに簡単に組み込めます。

読み取り専用・残高に触れない ワンクリック発行 / リセット JSON レスポンスで統合容易

照会できる内容

1 つのトークンで API キーの主要な運用指標をカバー

有効期限

各アクティブ API キーの正確な有効期限。早めに更新を計画し、停止を回避できます。

日次・月次の使用量

本日の費用とリクエスト数、今月のクォータ使用量 / 上限と使用率がひと目で分かります。

トークンのセルフ管理

ダッシュボードでトークンを発行・リセット・失効。サーバーはハッシュのみ保存し、平文は一度だけ表示します。

3 ステップで統合

トークン発行からクエリ成功まで数分

1

ダッシュボードでトークンを発行

ログイン後「オープン API」を開き、生成をクリックすると qot_ で始まるトークンが得られます(大切に保管)。

2

トークンを付けて API を呼ぶ

Authorization: Bearer qot_... を付けて GET /api/v1/openapi/keys を呼ぶと使用量が JSON で返ります。

3

ツールに統合

レスポンスをスクリプト・監視ダッシュボード・期限アラート・CI に流して運用を自動化。

1 コマンドで開始

標準 HTTP + Bearer トークン。どの言語からでも呼べます

各アクティブキーの名前・有効期限・本日の使用量・月次クォータを含む構造化 JSON を返し、そのまま解析できます。

  • 読み取り専用:自分のアカウントの API キーのみ照会でき、作成・変更・残高消費はできません。
  • キャッシュとレート制限を内蔵し、高速かつ上流に優しい設計です。
# リクエスト
curl -H "Authorization: Bearer qot_xxx" \
  https://qcode.cc/api/v1/openapi/keys

レスポンス例

{
  "ok": true,
  "data": {
    "keys": [{
      "name": "Pro unlimited/day",
      "is_active": true,
      "expires_at_display": "2026/08/22 21:35",
      "current_daily_cost": 42.04,
      "current_requests": 115,
      "monthly_cost_used": 8837.56,
      "monthly_cost_limit": 13000.0
    }],
    "active_api_keys": 1
  }
}

エンドポイント一覧

すべて読み取り専用 GET、認証は Bearer トークンで統一

エンドポイント 説明
GET /api/v1/openapi/keys全アクティブ API キーの有効期限・本日の使用量・月次クォータ・使用率を一覧。
GET /api/v1/openapi/meアカウント単位のサマリー:アクティブキー数と本日の合計費用。
GET /api/v1/openapiセルフ説明:エンドポイント一覧と使い方を返し、死活確認に便利。

代表的なユースケース

使用量データを既存のワークフローに接続

期限アラート

定期的に有効期限を確認し、期限前にメール / IM / Telegram で更新を自動通知。

使用量ダッシュボード

日次費用とクォータ使用率を Grafana や表計算、自作パネルに取り込み。

複数キーの巡回監視

チームが複数キーを持つ場合、すべてのキーの状態とクォータを一括取得。

CI / 自動化

高価な AI ジョブの前に、パイプラインでキーの有効性とクォータを検証。

セキュリティ設計

トークンは高エントロピーのランダム文字列で、サーバーは HMAC ハッシュのみ保存し平文は一度だけ表示。厳格な読み取り専用でキーの作成・管理や残高操作は不可、分単位 / 日単位のレート制限を内蔵。漏洩時はダッシュボードでワンクリック再発行すれば旧トークンは即無効になります。

よくある質問

アクセストークンの取得方法は?

QCode にログインし、ダッシュボードの「オープン API」カードで生成をクリック。平文トークンは一度だけ表示されるのですぐにコピーを。紛失時はいつでも再発行できます。

このトークンは安全ですか?

安全です。読み取り専用で、自分のアカウントの API キーの使用量と期限のみ照会でき、キーの作成 / 変更や残高消費はできません。サーバーはハッシュのみ保存し、漏洩時はワンクリック再発行で無効化されます。

呼び出し回数の制限はありますか?

あります。トークンごとに分単位・日単位の上限があり、結果は数秒キャッシュされるため通常のポーリングや監視には十分です。より高いクォータが必要な場合はサポートへご連絡を。

今すぐ使用量を照会しよう

ダッシュボードにログインして読み取り専用トークンを発行し、数分で期限アラートと使用量ダッシュボードを構築。