プラットフォーム

アカウント使用API

クエリ残高、リクエスト履歴、使用カウンター、コスト、保存されたPlaygroundチャット

支出を照合したり、自分の製品内での使用状況を表示したり、保存したPlaygroundテストをエクスポートしたい場合にアカウントエンドポイントを使いましょう。

使用とバランス

GET /v1/account/usage現在のクレジット残高と、APIキーに紐づいたアカウントの最近の利用状況を返します。

$curl "https://api.empiriolabs.ai/v1/account/usage?limit=25" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

from、to、before、model、status、sourceで絞り込むことができます。サポートされるsource値はapi、playground、gpu_cloud、hosted_agentsです。

各使用イベントには以下が含まれます:

フィールド意味
sourceapi、playground、gpu_cloud、またはhosted_agents
modelとendpoint何と呼ばれていたか。GPU Cloud行の場合、modelはGPU SKU識別子です。
tokens入力、出力、キャッシュトークン、合計トークン数。GPU Cloud Runtimeイベントのようなトークン請求なしの行はトークンカウントがゼロで、ランタイムの詳細をmetadataに反映します。
cost.amount借方クレジットはUSDで。これがこの請求で何が起訴されたのかの唯一の真実の情報源です。
status、status_code、error結果の要求
output_urls生成されたメディアURLが存在する場合
metadata.agent_type / metadata.agent_name / metadata.agent_instance_idホストエージェントモデルの呼び出しを存在させて、使用状況をエージェントに遡ることができます。
metadata.gpu_slug / metadata.gpu_display / metadata.seconds / metadata.price_hourlyGPU Cloudランタイムイベントに表示し、表示名、実行時間、時間あたりのレートを調整しましょう。
metadata.tool_usageモデルが工具ごとの追加料金を請求した際の\{tool_name: count\}マップ(例:web_search、image_search、code_interpreter、web_extractor)。少なくとも一つのツールが発射された時だけ存在します。
metadata.list_cost / metadata.billed_cost / metadata.discount_amountアカウントレベルの価格割引が適用される場合にのみ存在します。cost.amountすでに割引後の金額を反映しています。これらの項目は領収書の割引を記録しています。

cost.amountは常に最終的な借方引き落とし額です。metadata.list_cost/metadata.billed_costペアは情報提供です。割引が適用されると、cost.amountはbilled_costとなります。割引が適用されない場合は、どちらのフィールドも設定されません。ただ読んでみてcost.amount。

GPU Cloudイベントについては、source: "gpu_cloud"プラスmetadata.secondsとmetadata.price_hourlyをランタイムレポートに使います。スキーマの安定性のためにtokensオブジェクトはレスポンス内に残りますが、GPUランタイムの行はトークン課金されません。

ツールの使用例

ツールごとの追加料金を請求するモデル(Qwen、Perplexity、MiMo、Mistral)を呼び出し、モデルがそれらのツールを呼び出すと、その応答には正規化されたtool_usageマップが含まれます。

1{
2  "id": "...",
3  "object": "usage_event",
4  "model": "qwen3-6-plus",
5  "cost": { "amount": 0.084, "currency": "USD" },
6  "tokens": { "input": 1250, "output": 480, "total": 1730 },
7  "metadata": {
8    "tool_usage": {
9      "web_search": 2,
10      "image_search": 1
11    }
12  }
13}

cost.amountにはすでに工具ごとの追加料金が含まれています(こちら:2 × $0.026 web_search + 1 × $0.0208 image_search + token cost)。どのツールが貢献したかをtool_usageで分解しましょう。

保存された遊び場チャット

公開APIは保存したPlaygroundの会話を読み取り専用リソースとして公開します。

保存したPlaygroundの会話をリストアップします:

$curl "https://api.empiriolabs.ai/v1/playground/conversations" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

IDで単一の会話を取得でき、その全メッセージ履歴も含めて:

$curl "https://api.empiriolabs.ai/v1/playground/conversations/CONVERSATION_ID" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Playgroundチャットの保存や削除はダッシュボード上で依然として行われています。