Kie.ai の残高確認:Credits と API キー設定

Kie.ai の Credits を確認し、専用 API キーで残高監視を設定。共有範囲、USD 換算、安全対策、初回照合とエラー対処を手順で説明します。

実アカウントでの確認待ち

ガイド更新日:

公式のアカウント Credits API、価格、公開コンソール資料に基づく実装です。ログイン後のキー作成、権限制限、金額照合は実アカウントで未検証です。自動テストは実機検証を意味しません。

必要な認証情報
Kie.ai API Key
監視通貨
USD · Credits 額面
監視の対象
API Credits · USD 額面
GET https://api.kie.ai/api/v1/chat/credit の成功応答 data はアカウント共有 Credits です。公式の 1 Credit = $0.005(200 Credits = $1)で正確に換算し、元の Credits も保持します。モデル、キー、Quota Monitor プロジェクト専用の残高ではありません。

キーを渡さず Kie.ai 残高を確認する方法

  1. kie.ai にログインし、API の支払いアカウントまたはチームを確認します。
  2. Billing で残り Credits を確認します。200 Credits = $1 額面で、累計消費やキーの制限ではありません。
  3. 必要な場合だけ公式でチャージし、反映後に再確認します。手動確認のためにキーを他人に渡す必要はありません。
Kie.ai の公式ページを開く(新しいタブで開きます)

Kie.ai を Quota Monitor に接続する

  1. 1. ログインして支払いアカウントを確認

    下の Billing を開き、Kie.ai API の支払いに使用しているアカウントでログインします。チームに参加している場合は現在の支払い元を確認し、表示された Credits と時刻を控えます。モデル開発元のサイトやチャット契約とは比較しません。

    確認:対象アカウントの Credits が見えること。監視のために購入、生成、チーム参加をする必要はありません。手動確認だけならここで終了できます。

  2. 2. 監視専用キーを作成

    同じアカウントで API Keys を開き、Create New Key(画面によっては Create API key)を選択します。Name に Quota Monitor と入力し Create Key を押します。既存の本番キーはコピーせず、作成権限がなければ既存管理者に依頼してください。

    確認:作成が成功し Secret Key が表示されます。監視用と識別できる名前にしますが、名前は権限を制限しません。Read Only と名付けても読み取り専用にはなりません。

  3. 3. 権限と任意の安全対策を確認

    通常のキーはモデル呼び出しで Credits を消費できます。API Keys の Allowed Models、Safe-Spend Limits、IP Whitelist はリスクを抑えますが、残高専用の権限は公式資料で互換性を確認できていません。制限値の 0 は無制限であり、消費禁止ではありません。

    確認:専用キーの暗号化保管を許容できること。問題解決のため All Models に広げたり既存制限を解除したりしないでください。IP リストには監視サーバーの確認済み固定送信 IP が必要で、自分の端末やサイトのドメインではありません。本サービスは固定送信 IP を保証しないため、必須なら手動確認を使ってください。

  4. 4. 秘密値を安全に保存

    成功画面の Copy key / Copy で Secret Key をコピーし、閉じる前にパスワード管理ソフトへ保存します。再表示できない場合があると案内されています。失ったら再作成し、伏せ字や末尾 4 文字を使わないでください。

    確認:完全なキーのみで、Authorization: Bearer、引用符、改行、前後の空白がないこと。チャット、画像、問い合わせ、URL、外部オンライン API テスターに入れないでください。

  5. 5. プロジェクト内に Kie.ai を追加

    Quota Monitor の対象プロジェクト → 接続を追加 → 新規接続で Kie.ai(Credits · USD 額面)を選択します。識別できる接続名を入力し、Kie.ai API Key のパスワード欄に完全な値を貼り付けて保存します。

    確認:必要なのはキー 1 個だけです。API URL、Account ID、上流プロジェクト、Key ID は不要で通貨は USD 固定、秘密値は暗号化されます。MCP では安全な入力リンクだけを使い、Agent との会話には送らないでください。

  6. 6. 同期して単位を照合

    初回同期を待つか最新残高の取得を選び、新しい成功時刻を確認します。同じ支払いアカウントの Billing と比較してください。4900 Credits は $24.5 と 4900 Credits の併記となり、$4900 ではありません。

    確認:USD 額面は credits / 200 で、利用費の再控除は不要です。通知しきい値と日次消費設定は Credits ではなく USD を使います。初回検証では匿名化した金額、範囲、時刻のみ記録し、応答全体や秘密値は共有しません。

  7. 7. 必要な場合のみ公式でチャージ

    残高が減ったらカードのプラットフォームを開くボタンで Billing に移動し、アカウントを再確認します。購入が必要なら支払い権限のある人が現在のチャージ画面で金額と請求を確認して決済します。監視接続自体は購入不要です。

    確認:公式 Credits が増えた後にこちらで再取得します。特典、割引、税、返金は現在の公式条件に従い、USD 額面は返金保証ではありません。本サービスは自動チャージや支払い方法変更をしません。

  8. 8. キーを交換して古いものを失効

    API Keys で代替キーを作り、新規接続の同期を確認します。古い接続の全プロジェクト参照を外して削除した後、Kie.ai で古い監視キーの Revoke Key を選び確認します。本番キーを失効しないよう名前を確認してください。

    確認:新しい同期が成功し古いキーが失効していること。こちらでの接続削除は上流の失効操作ではありません。最後のキーを削除できない場合は利用可能な代替キーを残し、公式画面の案内に従ってください。無関係の認証情報は削除しません。

Quota Monitor が取得する Kie.ai のデータ範囲

  • Kie.ai は複数モデルを提供するプラットフォームです。この連携は Kie.ai アカウントのみを読み、モデル開発元の残高やチャット製品の契約は対象外です。同じアカウントを使うキーやプロジェクトの Credits を重複合算しないでください。
  • USD 額面 = credits / 200 であり、モデル単価や過去の利用量による推計ではありません。費用を再控除しません。Credits は出金可能な現金ではなく、特典や割引があれば支払額と額面は異なります。現金・特典内訳、有効期限、モデル別枠は返されません。
  • 取得時刻は決済確定時刻ではなく、遅延ゼロやモデル利用を保証しません。Allowed Models、Safe-Spend Limits、IP Whitelist により利用が制限される場合があります。本版はキー制限を取得しません。
  • 業務コード code=200 と有効な数値 data の場合だけ更新します。HTTP 200 内の 401、402、429、455 などは残高ゼロではありません。失敗時は前回の成功値と時刻を保持します。生成、チャージ、アカウント変更は行いません。
  • ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。

Kie.ai のよくある質問とトラブルシューティング

401、403、キー形式エラーの対処は?
API Keys から完全な専用キーを再コピーし、失効状態、アカウント権限、IP Whitelist を確認して Bearer と空白を除きます。Cookie は使わず、必須の制限を解除したり権限を拡大したりしないでください。固定送信 IP の要件を満たせなければ公式 Billing を使います。
公式の数字と 200 倍違うのはなぜ?
data はドルでなく Credits です。4900 Credits = $24.5 で、両方を表示し通知は USD 単位です。特典の額面を支払った現金とみなさず、モデル開発元の残高や別契約も加えません。
プロジェクト間で同額、または残高があるのにキーが上限になるのは?
取得するのは共有アカウント Credits で、キーの Safe-Spend Limits やモデル別上限ではありません。プロジェクトは分類用で、同じ残高を重複合算しません。正の残高でもモデル権限やキー制限などで利用できない場合があります。
HTTP 200 なのに失敗、または 402、429、455 の場合は?
HTTP 成功は業務成功ではありません。code=200 と有効な data のみ残高として扱います。402 を数値ゼロで代用しません。429 は頻度制限、455 はメンテナンスなので後で再取得します。非公開エンドポイントへの切替や推計はせず、失敗時は前回の成功値と時刻を保持します。
チャージ未反映やキー紛失の場合は?
同じ支払いアカウントに入金済みか確認して再取得します。直近の課金反映には遅延の可能性があります。秘密値を失ったら代替キーで接続を検証してから旧キーを失効し、本番キーは流用しません。解決しなければ匿名化した金額、エラーコード、時刻だけを共有してください。

Kie.ai の公式資料

Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。

Kie.ai を自動で監視する

コンソールを手動で確認するのは忘れがちです。Quota Monitor が公式 API を通じて Kie.ai のデータを取得します。

  • 既定で 10 分ごとに更新し、いつでも手動で更新できます。
  • 残高不足、無効なキー、同期エラーは概要の最上部に表示されます。
  • アカウントをプロジェクト別に整理し、リモート MCP 経由で Claude などの AI アシスタントから残高を確認できます。
無料で始める