纲领

账户使用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 运行时事件，返回零令牌计数，运行时细节放在metadata中。
cost.amount借记的信用额度以美元计。这是该请求所指控内容的唯一真实来源。
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_hourly在GPU 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 聊天仍然在仪表盘中进行。