Skip to Content
APIリファレンス使用状況日別の使用状況

日別の使用状況

GET/console/v1/accounts/{accountId}/activity

指定した期間の使用状況を、日付、プロジェクト、モデルごとに取得します。

認証

Authorizationstring必須

Bearer <マネジメントトークン> の形式で指定します。 詳しくは認証を参照してください。

パスパラメーター

accountIdstring必須

組織のID。 コンソールのURLの /accounts/ に続く部分です。

クエリパラメーター

startstring必須

期間の開始日。 日本時間の日付を YYYY-MM-DD で指定します。

endstring必須

期間の終了日。 日本時間の日付を YYYY-MM-DD で指定します。 指定した日も期間に含まれます。 期間は366日以内で指定します。

レスポンス

dataarray

使用状況の配列。 日付の古い順に並びます。

フィールドを表示フィールドを非表示
datestring

日付(日本時間、YYYY-MM-DD)。

projectIdstring | null

プロジェクトのID。 プロジェクトに紐づかない利用では null です。

modelstring | null

応答を生成したモデルのID。

totalsobject

集計値。 billingSource 以外の数値は、文字列で返ります。

フィールドを表示フィールドを非表示
requestCountstring

リクエスト数。

inputTokensstring

入力のトークン数。 キャッシュのトークン数を含みます。

outputTokensstring

出力のトークン数。

normalInputTokensstring

キャッシュを除いた入力のトークン数。

cacheReadInputTokensstring

キャッシュから読み取った入力のトークン数。

cacheCreationInputTokensstring

キャッシュに書き込んだ入力のトークン数。

cacheHitRatestring

入力のトークン数のうち、キャッシュから読み取った割合。

generatedVideoCountstring

生成した動画の本数。

fallbackRequestCountstring

フォールバックしたリクエスト数。

guardrailRequestCountstring

ガードレールが作動したリクエスト数。

billingSourcestring | null

利用の種類。 platform、byok、mixed のいずれかです。

platformUsageobject

BYOK以外の利用のリクエスト数とトークン数。

byokUsageobject

BYOKでの利用のリクエスト数、トークン数、費用の参考値。

chargeobject

請求額。 totalCostUsd(米ドル)、jpyCost(円)などを含みます。

エラー

エラーの形式はエラーを参照してください。

ステータスコードerror原因
400bad_requeststart または end の形式や期間が正しくない
401console_authentication_failedマネジメントトークンが正しくない、または有効期限が切れている
403console_authorization_denied使用状況を閲覧する権限がない
404not_foundリソースが見つからない、またはIDの形式が正しくない
422usage_activity_range_too_large期間内のデータが多すぎる。期間を短くして取得する
429rate_limitedレート制限を超えている
503console_usage_unavailableサービスが一時的に利用できない