{"meta":{"title":"使用状況と課金のメトリック","intro":"このガイドでは、Copilot SDK アプリケーションからトークン数、コンテキスト ウィンドウ使用率、AI クレジット コスト、アカウント クォータを読み取る方法について説明します。 TypeScript、Python、Go、.NET、Java、Rust の例を示します。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos","title":"方法"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk","title":"Copilot SDK"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features","title":"機能"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/usage-and-billing","title":"使用量と請求"}],"documentType":"article"},"body":"# 使用状況と課金のメトリック\n\nこのガイドでは、Copilot SDK アプリケーションからトークン数、コンテキスト ウィンドウ使用率、AI クレジット コスト、アカウント クォータを読み取る方法について説明します。 TypeScript、Python、Go、.NET、Java、Rust の例を示します。\n\n<!-- markdownlint-disable GHD046 GHD005 -->\n\n<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->\n\n> \\[!TIP]\n> 各例は、複数の言語で機能的に同等です。 TypeScript スニペットは既定で展開されます。折りたたみ可能なブロックから言語を選択して、その SDK で同じロジックを表示します。\n\n## 概要\n\nSDK は、次の 2 つの補完的なメカニズムを使用して使用状況データを表示します。\n\n* **セッション イベント**: ターンの実行時にランタイムが出力するエフェメラル イベント。 これらをサブスクライブして、リアルタイムの API 呼び出しごとのデータを取得します。\n* **RPC メソッド**: 要求時に行う要求/応答呼び出し。 累積合計のスナップショットを作成したり、アカウント レベルのクォータを検索したりするには、これらを使用します。\n\n次の表は、各シグナルを公開する API にマップします。\n\n| 信号                        | API                            | Scope   | タイプ |\n| ------------------------- | ------------------------------ | ------- | --- |\n| 呼び出しごとのトークン数              |                                |         |     |\n| `assistant.usage` 出来事     | Session                        | Event   |     |\n| コンテキスト ウィンドウの使用率          |                                |         |     |\n| `session.usage_info` 出来事  | Session                        | Event   |     |\n| コンテキストウィンドウの内訳（要求時）       | `session.metadata.contextInfo` | Session | RPC |\n| 累積 AI クレジットとトークンの合計       | `session.usage.getMetrics`     | Session | RPC |\n| モデルごとの AI クレジットの価格        | `models.list`                  | サーバー    | RPC |\n| アカウント クォータと Premium の相互作用 | `account.getQuota`             | サーバー    | RPC |\n\n> \\[!NOTE]\n> `session.usage.getMetrics`、 `session.metadata.contextInfo`、および `session.metadata.recomputeContextTokens` は、生成された RPC サーフェスで試験段階としてマークされます。 .NET では `GHCP001` の試験的診断メッセージが出力されます。これは `#pragma warning disable GHCP001`、またはプロジェクト レベルの `<NoWarn>GHCP001</NoWarn>` 設定で抑制できます。 アプリケーションがそれらに依存している場合は、SDK と Copilot CLI ランタイムの両方をピン留めします。\n\n次のフィールド テーブルには、このページの例で使用されているフィールドのみが一覧表示されます。 完全で常に最新のフィールド参照は、生成された SDK の種類と [AUTOTITLE です。AUTOTITLE](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/streaming-events) は、依存関係のバンプごとに CLI スキーマから再生成されます。 それらを真理の源として扱い、このページをタスク指向のガイドとして扱います。\n\n## 呼び出しごとのトークン数\n\n`assistant.usage` イベントは、モデル API 呼び出しごとに 1 回だけ生成されます (サブエージェントによる呼び出しを含む)。 トークン数と、その1回の呼び出しに対する課金乗数が含まれます。\n\n次の例では、これらのフィールドを使用します。 キャッシュ、推論、待機時間、トレース フィールドなど、完全な一覧については [AUTOTITLE を](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/streaming-events#assistantusage) 参照してください。\n\n| フィールド          | タイプ      | Description               |\n| -------------- | -------- | ------------------------- |\n| `model`        | `string` | この呼び出しのモデル識別子             |\n| `inputTokens`  | `number` | 使用された入力トークン               |\n| `outputTokens` | `number` | 生成された出力トークン               |\n| `cost`         | `number` | この呼び出しに適用されるプレミアム リクエスト乗数 |\n\n> \\[!TIP]\n> `assistant.usage` はエフェメラルであるため、ライブ配信されますが、セッションを再開するときに再生されません。 その後の累積合計を読み取るために、 `session.usage.getMetrics` を呼び出します ( [「累積 AI クレジットとトークンの合計](#accumulated-ai-credit-and-token-totals)」を参照)。\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nsession.on(\"assistant.usage\", (event) => {\n    const { model, inputTokens, outputTokens, cost } = event.data;\n    console.log(\n        `${model}: in=${inputTokens ?? 0} out=${outputTokens ?? 0} cost=${cost ?? 0}`,\n    );\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\ndef on_usage(event):\n    if event.type == SessionEventType.ASSISTANT_USAGE:\n        data = event.data\n        print(f\"{data.model}: in={data.input_tokens or 0} out={data.output_tokens or 0} cost={data.cost or 0}\")\n\nsession.on(on_usage)\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nsession.On(func(event copilot.SessionEvent) {\n    d, ok := event.Data.(*copilot.AssistantUsageData)\n    if !ok {\n        return\n    }\n    in, out, cost := int64(0), int64(0), float64(0)\n    if d.InputTokens != nil {\n        in = *d.InputTokens\n    }\n    if d.OutputTokens != nil {\n        out = *d.OutputTokens\n    }\n    if d.Cost != nil {\n        cost = *d.Cost\n    }\n    fmt.Printf(\"%s: in=%d out=%d cost=%g\\n\", d.Model, in, out, cost)\n})\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nsession.On<AssistantUsageEvent>(evt =>\n{\n    var data = evt.Data;\n    Console.WriteLine(\n        $\"{data.Model}: in={data.InputTokens ?? 0} out={data.OutputTokens ?? 0} cost={data.Cost ?? 0}\");\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nsession.on(AssistantUsageEvent.class, event -> {\n    var data = event.getData();\n    long in = data.inputTokens() != null ? data.inputTokens() : 0;\n    long out = data.outputTokens() != null ? data.outputTokens() : 0;\n    double cost = data.cost() != null ? data.cost() : 0.0;\n    System.out.printf(\"%s: in=%d out=%d cost=%s%n\", data.model(), in, out, cost);\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nuse github_copilot_sdk::session_events::AssistantUsageData;\n\nlet mut events = session.subscribe();\nwhile let Ok(event) = events.recv().await {\n    if event.event_type == \"assistant.usage\" {\n        if let Some(data) = event.typed_data::<AssistantUsageData>() {\n            println!(\n                \"{}: in={} out={} cost={}\",\n                data.model,\n                data.input_tokens.unwrap_or(0),\n                data.output_tokens.unwrap_or(0),\n                data.cost.unwrap_or(0.0),\n            );\n        }\n    }\n}\n```\n\n</div>\n\n</div>\n\n## コンテキスト ウィンドウの使用率\n\nトークン数は、各呼び出しで使用された内容を示します。 コンテキスト ウィンドウの使用率は、モデルのプロンプト ウィンドウが現在どの程度満たされているかを示します。これは、自動圧縮が開始される前に進行状況バーを表示したり、ユーザーに警告したりするのに役立ちます。\n\n### `session.usage_info` によるリアルタイム更新\n\nランタイムは、コンテキスト ウィンドウのサイズが変更されるたびに、 `session.usage_info` イベントを生成します。 この例では、 `currentTokens` と `tokenLimit`を使用しています。完全なペイロードについては [ストリーミング セッション イベント](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/streaming-events#sessionusage_info) を参照してください。\n\n| フィールド           | タイプ      | Description              |\n| --------------- | -------- | ------------------------ |\n| `currentTokens` | `number` | 現在コンテキスト ウィンドウ内のトークン     |\n| `tokenLimit`    | `number` | モデルのコンテキスト ウィンドウの最大トークン数 |\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nsession.on(\"session.usage_info\", (event) => {\n    const { currentTokens, tokenLimit } = event.data;\n    const pct = Math.round((currentTokens / tokenLimit) * 100);\n    console.log(`Context: ${currentTokens}/${tokenLimit} (${pct}%)`);\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\ndef on_usage_info(event):\n    if event.type == SessionEventType.SESSION_USAGE_INFO:\n        data = event.data\n        pct = round(data.current_tokens / data.token_limit * 100)\n        print(f\"Context: {data.current_tokens}/{data.token_limit} ({pct}%)\")\n\nsession.on(on_usage_info)\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nsession.On(func(event copilot.SessionEvent) {\n    d, ok := event.Data.(*copilot.SessionUsageInfoData)\n    if !ok {\n        return\n    }\n    pct := int(float64(d.CurrentTokens) / float64(d.TokenLimit) * 100)\n    fmt.Printf(\"Context: %d/%d (%d%%)\\n\", d.CurrentTokens, d.TokenLimit, pct)\n})\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nsession.On<SessionUsageInfoEvent>(evt =>\n{\n    var pct = (int)Math.Round((double)evt.Data.CurrentTokens / evt.Data.TokenLimit * 100);\n    Console.WriteLine($\"Context: {evt.Data.CurrentTokens}/{evt.Data.TokenLimit} ({pct}%)\");\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nsession.on(SessionUsageInfoEvent.class, event -> {\n    var data = event.getData();\n    long pct = Math.round((double) data.currentTokens() / data.tokenLimit() * 100);\n    System.out.printf(\"Context: %d/%d (%d%%)%n\", data.currentTokens(), data.tokenLimit(), pct);\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nuse github_copilot_sdk::session_events::SessionUsageInfoData;\n\nlet mut events = session.subscribe();\nwhile let Ok(event) = events.recv().await {\n    if event.event_type == \"session.usage_info\" {\n        if let Some(data) = event.typed_data::<SessionUsageInfoData>() {\n            let pct = (data.current_tokens as f64 / data.token_limit as f64 * 100.0) as i64;\n            println!(\"Context: {}/{} ({}%)\", data.current_tokens, data.token_limit, pct);\n        }\n    }\n}\n```\n\n</div>\n\n</div>\n\n### `session.metadata.contextInfo` を使用したオンデマンドの内訳\n\nイベントは、コンテキストが変更されたときにのみ発生します。 セッションの再開直後など、いつでも現在の内訳を読み取るために、 `session.metadata.contextInfo`を呼び出します。 ランタイムの既定値を使用する`promptTokenLimit`の`0`を渡します。値が不明な場合は、`outputTokenLimit`に`0`を渡します。\n\n結果の `contextInfo` は、セッションが初期化されるまで `null` されます (システム プロンプトとツールメタデータがキャッシュされています)。 合計は、`promptTokenLimit`と共に`systemTokens`、`conversationTokens`、`toolDefinitionsTokens`に分割されます。\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nconst { contextInfo } = await session.rpc.metadata.contextInfo({\n    promptTokenLimit: 0,\n    outputTokenLimit: 0,\n});\n\nif (contextInfo) {\n    console.log(\n        `Total ${contextInfo.totalTokens}/${contextInfo.promptTokenLimit} ` +\n            `(system=${contextInfo.systemTokens}, conversation=${contextInfo.conversationTokens})`,\n    );\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nresult = await session.rpc.metadata.context_info(\n    MetadataContextInfoRequest(prompt_token_limit=0, output_token_limit=0)\n)\ninfo = result.context_info\n\nif info is not None:\n    print(\n        f\"Total {info.total_tokens}/{info.prompt_token_limit} \"\n        f\"(system={info.system_tokens}, conversation={info.conversation_tokens})\"\n    )\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nresult, _ := session.RPC.Metadata.ContextInfo(ctx, &rpc.MetadataContextInfoRequest{\n    PromptTokenLimit: 0,\n    OutputTokenLimit: 0,\n})\n\nif info := result.ContextInfo; info != nil {\n    fmt.Printf(\"Total %d/%d (system=%d, conversation=%d)\\n\",\n        info.TotalTokens, info.PromptTokenLimit, info.SystemTokens, info.ConversationTokens)\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nvar result = await session.Rpc.Metadata.ContextInfoAsync(promptTokenLimit: 0, outputTokenLimit: 0);\nvar info = result.ContextInfo;\n\nif (info is not null)\n{\n    Console.WriteLine(\n        $\"Total {info.TotalTokens}/{info.PromptTokenLimit} \" +\n        $\"(system={info.SystemTokens}, conversation={info.ConversationTokens})\");\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nvar result = session.getRpc().metadata\n    .contextInfo(new SessionMetadataContextInfoParams(null, 0L, 0L, null))\n    .join();\nvar info = result.contextInfo();\n\nif (info != null) {\n    System.out.printf(\"Total %d/%d (system=%d, conversation=%d)%n\",\n        info.totalTokens(), info.promptTokenLimit(), info.systemTokens(), info.conversationTokens());\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nuse github_copilot_sdk::rpc::MetadataContextInfoRequest;\n\nlet result = session\n    .rpc()\n    .metadata()\n    .context_info(MetadataContextInfoRequest {\n        prompt_token_limit: 0,\n        output_token_limit: 0,\n        selected_model: None,\n    })\n    .await?;\n\nif let Some(info) = result.context_info {\n    println!(\n        \"Total {}/{} (system={}, conversation={})\",\n        info.total_tokens, info.prompt_token_limit, info.system_tokens, info.conversation_tokens,\n    );\n}\n```\n\n</div>\n\n</div>\n\n## 累積 AI クレジットとトークンの合計\n\n`session.usage.getMetrics` は、1 回の呼び出しでセッション全体の実行合計を返します。 これは、すべての API 呼び出し (メイン エージェントとサブエージェント) を集計するため、AI クレジット コストを読み取る最もクリーンな方法です。\n\nこの例では、次のフィールドを使用します。 生成された `UsageGetMetricsResult` 型は完全な参照です。\n\n| フィールド                     | タイプ                           | Description                                                                    |\n| ------------------------- | ----------------------------- | ------------------------------------------------------------------------------ |\n| `totalNanoAiu`            | `number`                      | セッション全体の AI クレジット コスト (nano-AI ユニット単位)                                         |\n| `totalPremiumRequestCost` | `number`                      | すべてのモデルにおける、乗数適用後の Premium リクエスト コスト                                           |\n| `modelMetrics`            | `Record<string, ModelMetric>` | モデルごとの内訳。各エントリには、 `usage.inputTokens`、 `usage.outputTokens`、および `totalNanoAiu` |\n\n> \\[!NOTE]\n> コストは **nano-AI ユニット** で報告されます (フィールドの名前は `totalNanoAiu`)。 AI クレジットへの正確な変換と Premium 要求アカウンティングの正確な意味は、SDK ではなくGitHub Copilot課金によって定義されます。[GitHubのCopilot課金ドキュメント](/ja/enterprise-cloud@latest/copilot/concepts/billing)を真実のソースとして扱い、通貨のような値をユーザーに表示する前に検証します。 例では、便宜上、SI の `1e9` 接頭辞に従って `nano` で除算しています。これを当てにする前に、現在の請求と一致していることを確認してください。\n> `modelMetrics`マップと`tokenDetails` マップは、SDK 型システムが検証しないランタイム文字列 (モデル ID とトークン型名) によってキー付けされます。\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nconst metrics = await session.rpc.usage.getMetrics();\n\nconst aiCredits = (metrics.totalNanoAiu ?? 0) / 1e9;\nconsole.log(`AI credits used: ${aiCredits.toFixed(6)}`);\nconsole.log(`Premium requests: ${metrics.totalPremiumRequestCost}`);\n\nfor (const [model, m] of Object.entries(metrics.modelMetrics)) {\n    if (!m) continue;\n    console.log(\n        `${model}: in=${m.usage.inputTokens} out=${m.usage.outputTokens} ` +\n            `nanoAiu=${m.totalNanoAiu ?? 0}`,\n    );\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nmetrics = await session.rpc.usage.get_metrics()\n\nai_credits = (metrics.total_nano_aiu or 0) / 1e9\nprint(f\"AI credits used: {ai_credits:.6f}\")\nprint(f\"Premium requests: {metrics.total_premium_request_cost}\")\n\nfor model, m in metrics.model_metrics.items():\n    print(f\"{model}: in={m.usage.input_tokens} out={m.usage.output_tokens} nanoAiu={m.total_nano_aiu or 0}\")\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nmetrics, _ := session.RPC.Usage.GetMetrics(ctx)\n\naiCredits := float64(0)\nif metrics.TotalNanoAiu != nil {\n    aiCredits = *metrics.TotalNanoAiu / 1e9\n}\nfmt.Printf(\"AI credits used: %.6f\\n\", aiCredits)\nfmt.Printf(\"Premium requests: %v\\n\", metrics.TotalPremiumRequestCost)\n\nfor model, m := range metrics.ModelMetrics {\n    nanoAiu := float64(0)\n    if m.TotalNanoAiu != nil {\n        nanoAiu = *m.TotalNanoAiu\n    }\n    fmt.Printf(\"%s: in=%d out=%d nanoAiu=%v\\n\", model, m.Usage.InputTokens, m.Usage.OutputTokens, nanoAiu)\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nvar metrics = await session.Rpc.Usage.GetMetricsAsync();\n\nvar aiCredits = (metrics.TotalNanoAiu ?? 0) / 1e9;\nConsole.WriteLine($\"AI credits used: {aiCredits:F6}\");\nConsole.WriteLine($\"Premium requests: {metrics.TotalPremiumRequestCost}\");\n\nforeach (var (model, m) in metrics.ModelMetrics)\n{\n    Console.WriteLine(\n        $\"{model}: in={m.Usage.InputTokens} out={m.Usage.OutputTokens} nanoAiu={m.TotalNanoAiu ?? 0}\");\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nvar metrics = session.getRpc().usage.getMetrics().join();\n\ndouble aiCredits = metrics.totalNanoAiu() != null ? metrics.totalNanoAiu() / 1e9 : 0;\nSystem.out.printf(\"AI credits used: %.6f%n\", aiCredits);\nSystem.out.printf(\"Premium requests: %s%n\", metrics.totalPremiumRequestCost());\n\nmetrics.modelMetrics().forEach((model, m) -> {\n    double nanoAiu = m.totalNanoAiu() != null ? m.totalNanoAiu() : 0;\n    System.out.printf(\"%s: in=%d out=%d nanoAiu=%s%n\",\n        model, m.usage().inputTokens(), m.usage().outputTokens(), nanoAiu);\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nlet metrics = session.rpc().usage().get_metrics().await?;\n\nlet ai_credits = metrics.total_nano_aiu.unwrap_or(0.0) / 1e9;\nprintln!(\"AI credits used: {ai_credits:.6}\");\nprintln!(\"Premium requests: {}\", metrics.total_premium_request_cost);\n\nfor (model, m) in &metrics.model_metrics {\n    let nano_aiu = m.total_nano_aiu.unwrap_or(0.0);\n    println!(\n        \"{model}: in={} out={} nanoAiu={nano_aiu}\",\n        m.usage.input_tokens, m.usage.output_tokens,\n    );\n}\n```\n\n</div>\n\n</div>\n\n## モデルごとの AI クレジットの価格\n\nターンを実行する前にコストを見積もるために、各モデルのトークン価格を `models.list`から読み取ってください。 これはクライアントでのサーバー スコープの呼び出しであるため、セッションは必要ありません。 価格は、トークンの課金バッチごとに AI クレジットで表されます。 生成された `ModelBillingTokenPrices` 型には、 `cachePrice`を含むすべてのフィールドが一覧表示されます。\n\n| フィールド                             | タイプ      | Description                 |\n| --------------------------------- | -------- | --------------------------- |\n| `billing.multiplier`              | `number` | 基本レートに対する Premium 要求コスト乗数   |\n| `billing.tokenPrices.inputPrice`  | `number` | 入力トークンのバッチあたりの AI クレジット コスト |\n| `billing.tokenPrices.outputPrice` | `number` | 出力トークンのバッチあたりの AI クレジット コスト |\n| `billing.tokenPrices.batchSize`   | `number` | 課金バッチあたりのトークン数              |\n\n> \\[!NOTE]\n> 価格の値は、プランとモデルの進化に伴って変化します。 次に示すように、実行時にそれらを読み取ります。アプリケーションに番号をハードコーディングしないでください。\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nconst { models } = await client.rpc.models.list({});\n\nfor (const model of models) {\n    const prices = model.billing?.tokenPrices;\n    if (!prices) continue;\n    console.log(\n        `${model.id}: input=${prices.inputPrice} output=${prices.outputPrice} ` +\n            `per ${prices.batchSize} tokens (x${model.billing?.multiplier ?? 1})`,\n    );\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nresult = await client.rpc.models.list(ModelsListRequest())\n\nfor model in result.models:\n    prices = model.billing.token_prices if model.billing else None\n    if prices is None:\n        continue\n    multiplier = model.billing.multiplier if model.billing else 1\n    print(\n        f\"{model.id}: input={prices.input_price} output={prices.output_price} \"\n        f\"per {prices.batch_size} tokens (x{multiplier})\"\n    )\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nlist, _ := client.RPC.Models.List(ctx, &rpc.ModelsListRequest{})\n\nfor _, model := range list.Models {\n    if model.Billing == nil || model.Billing.TokenPrices == nil {\n        continue\n    }\n    prices := model.Billing.TokenPrices\n    multiplier := 1.0\n    if model.Billing.Multiplier != nil {\n        multiplier = *model.Billing.Multiplier\n    }\n    in, out := 0.0, 0.0\n    if prices.InputPrice != nil {\n        in = *prices.InputPrice\n    }\n    if prices.OutputPrice != nil {\n        out = *prices.OutputPrice\n    }\n    batch := int64(0)\n    if prices.BatchSize != nil {\n        batch = *prices.BatchSize\n    }\n    fmt.Printf(\"%s: input=%v output=%v per %d tokens (x%v)\\n\", model.ID, in, out, batch, multiplier)\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nvar list = await client.Rpc.Models.ListAsync();\n\nforeach (var model in list.Models)\n{\n    var prices = model.Billing?.TokenPrices;\n    if (prices is null) continue;\n    Console.WriteLine(\n        $\"{model.Id}: input={prices.InputPrice} output={prices.OutputPrice} \" +\n        $\"per {prices.BatchSize} tokens (x{model.Billing?.Multiplier ?? 1})\");\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nvar list = client.getRpc().models.list().join();\n\nfor (var model : list.models()) {\n    var billing = model.billing();\n    if (billing == null || billing.tokenPrices() == null) {\n        continue;\n    }\n    var prices = billing.tokenPrices();\n    double multiplier = billing.multiplier() != null ? billing.multiplier() : 1;\n    System.out.printf(\"%s: input=%s output=%s per %d tokens (x%s)%n\",\n        model.id(), prices.inputPrice(), prices.outputPrice(), prices.batchSize(), multiplier);\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nlet list = client.rpc().models().list().await?;\n\nfor model in &list.models {\n    let Some(billing) = &model.billing else { continue };\n    let Some(prices) = &billing.token_prices else { continue };\n    let multiplier = billing.multiplier.unwrap_or(1.0);\n    println!(\n        \"{}: input={} output={} per {} tokens (x{multiplier})\",\n        model.id,\n        prices.input_price.unwrap_or(0.0),\n        prices.output_price.unwrap_or(0.0),\n        prices.batch_size.unwrap_or(0),\n    );\n}\n```\n\n</div>\n\n</div>\n\n## アカウント クォータと Premium の相互作用\n\n`account.getQuota`は、認証されたユーザーの残りのCopilot資格を報告します。 結果の `quotaSnapshots` マップは、クォータの種類 (一般的に `premium_interactions`、 `chat`、 `completions`) によってキーが設定されます。 これを使用して、毎月の許容量がどれだけ残っているかをユーザーに示したり、制限に達する前に作業を制限したりします。\n\nこの例では、次のフィールドを使用します。生成された `AccountQuotaSnapshot` 型は完全な参照です。\n`quotaSnapshots` キーは、SDK 型システムでは検証されないランタイム文字列であるため、参照を保護します。\n\n| フィールド                 | タイプ      | Description                          |\n| --------------------- | -------- | ------------------------------------ |\n| `entitlementRequests` | `number` | エンタイトルメントに含まれるリクエスト数、または無制限の場合は `-1` |\n| `usedRequests`        | `number` | この期間にこれまでに使用された要求                    |\n| `remainingPercentage` | `number` | 残りの権利の割合                             |\n| `resetDate`           | `string` | クォータがリセットされた ISO 8601 日付             |\n\n> \\[!TIP]\n> 接続のグローバル認証コンテキスト (マルチテナント バックエンドなど) ではなく、特定のユーザーのクォータを読み取るために、そのユーザーのGitHub トークンを`getQuota`に渡します。 「[マルチテナントとサーバーの展開](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/setup/multi-tenancy)」を参照してください。\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nconst { quotaSnapshots } = await client.rpc.account.getQuota({});\nconst premium = quotaSnapshots[\"premium_interactions\"];\n\nif (premium) {\n    console.log(\n        `Premium interactions: ${premium.usedRequests}/${premium.entitlementRequests} ` +\n            `(${premium.remainingPercentage.toFixed(1)}% left, resets ${premium.resetDate ?? \"n/a\"})`,\n    );\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nresult = await client.rpc.account.get_quota(AccountGetQuotaRequest())\npremium = result.quota_snapshots.get(\"premium_interactions\")\n\nif premium is not None:\n    print(\n        f\"Premium interactions: {premium.used_requests}/{premium.entitlement_requests} \"\n        f\"({premium.remaining_percentage:.1f}% left, resets {premium.reset_date or 'n/a'})\"\n    )\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nresult, _ := client.RPC.Account.GetQuota(ctx, &rpc.AccountGetQuotaRequest{})\n\nif premium, ok := result.QuotaSnapshots[\"premium_interactions\"]; ok {\n    resets := \"n/a\"\n    if premium.ResetDate != nil {\n        resets = premium.ResetDate.Format(time.RFC3339)\n    }\n    fmt.Printf(\"Premium interactions: %d/%d (%.1f%% left, resets %s)\\n\",\n        premium.UsedRequests, premium.EntitlementRequests, premium.RemainingPercentage, resets)\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nvar result = await client.Rpc.Account.GetQuotaAsync();\n\nif (result.QuotaSnapshots.TryGetValue(\"premium_interactions\", out var premium))\n{\n    Console.WriteLine(\n        $\"Premium interactions: {premium.UsedRequests}/{premium.EntitlementRequests} \" +\n        $\"({premium.RemainingPercentage:F1}% left, resets {premium.ResetDate?.ToString(\"o\") ?? \"n/a\"})\");\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nvar result = client.getRpc().account.getQuota().join();\nvar premium = result.quotaSnapshots().get(\"premium_interactions\");\n\nif (premium != null) {\n    System.out.printf(\"Premium interactions: %d/%d (%.1f%% left, resets %s)%n\",\n        premium.usedRequests(), premium.entitlementRequests(),\n        premium.remainingPercentage(), premium.resetDate());\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nlet result = client.rpc().account().get_quota().await?;\n\nif let Some(premium) = result.quota_snapshots.get(\"premium_interactions\") {\n    let resets = premium.reset_date.as_deref().unwrap_or(\"n/a\");\n    println!(\n        \"Premium interactions: {}/{} ({:.1}% left, resets {resets})\",\n        premium.used_requests, premium.entitlement_requests, premium.remaining_percentage,\n    );\n}\n```\n\n</div>\n\n</div>\n\n## 適切な API の選択\n\nこの概要を使用して、ユース ケースに適した API を決定します。\n\n* **ターンの実行時にライブ コストまたはトークン メーターをレンダリング**します。 `assistant.usage` と `session.usage_info`をサブスクライブします。\n* **ターンまたはセッション後の最終的なコストの概要を表示**する: `session.usage.getMetrics`を呼び出します。\n* **新しいターンの前に、再開時にコンテキスト ウィンドウの使用状況を表示**する: `session.metadata.contextInfo`を呼び出します。\n* **作業を実行する前にコストを見積も**る: トークンの価格 `models.list` 読み取る。\n* **プランを使い果たす前にユーザーに警告**する: `account.getQuota`を呼び出します。\n\n## 詳細については、次を参照してください。\n\n* [ストリーミング セッション イベント](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/streaming-events): `assistant.usage`、 `session.usage_info`、およびその他のすべてのセッション イベントのフィールド レベルの完全なリファレンス\n* [可観測性](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/observability): コスト属性のために使用状況データを OpenTelemetry にエクスポートする\n* [マルチテナントとサーバーの展開](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/setup/multi-tenancy): GitHub トークンを使用してユーザーごとのクォータとモデルを解決する"}