Agent API

签发一个只读令牌，让脚本或 Agent 以程序方式读取你的账户 —— 当前余额、消费与用量、以及实时的模型目录。它是只读的：能看这些信息，但 不能扣费，也与用于推理的 sk-miaotui- 密钥相互独立。 认证时使用这个令牌（rk-miaotui-…）。

1. 签发只读令牌

进入 控制台 → 账户令牌，创建一个令牌并复制 （只显示一次）。

2. 调用接口

curl -H 'Authorization: Bearer rk-miaotui-…' \
  https://miaotui.net/api/v1/balance

成功响应是 { "data": …, "meta": … }；错误是 { "error": { "code", "message" } }。金额是整数 µUSD （1 美元 = 1,000,000），同时也附带一个 _usd 字符串字段。

注意接口返回的是美元口径：账本以美元记账， 人民币只在页面展示层按固定汇率换算。要人民币金额，请自行乘以汇率。

3. 接口列表

• GET /api/v1/balance —— 余额与可用余额（已扣除冻结）。
• GET /api/v1/usage?days=7|30&model=… —— 按日、按模型的请求数与消费。
• GET /api/v1/models —— 实时模型列表，含每千 token 单价与上下文限制。

4. 机器可读

• /api/v1/openapi.json —— OpenAPI 3.1。
• /api/v1/llms.txt —— 给 Agent 看的精简文本。

限流：每个令牌每分钟 120 次请求。