连接模型，
让创意自由生长。

直接从 API 响应读取 Vimoney usage

使用 Vimox API Key 或 OAuth token 发起文本、生图、生视频等真实计费请求时，Router 会先把扣费/退款写入本地加密账务队列，再在本次响应中返回 vimox_usage。远端结算由后台处理，不阻塞模型响应；charge_pending / refund_pending 表示账务仍在队列中，remaining_vimoney 为 null。

{
  "vimox_usage": {
    "consumed_vimoney": "2",
    "consumed_vimoney_micros": 2000000,
    "refunded_vimoney": null,
    "refunded_vimoney_micros": null,
    "remaining_vimoney": null,
    "billing_status": "charge_pending",
    "unit": "ViMoney",
    "trace_id": "..."
  }
}

• 非流式 JSON：读取顶层 vimox_usage。
• 流式 SSE：读取最终 usage 帧中的 vimox_usage；上游没有 usage 帧时读取 event: vimox.usage。
• charge_pending / refund_pending 表示已持久入队、等待后台确认；后续请求不会等待远端扣费。
• 任务终态失败且退款已完成后返回 billing_status: refunded 与退款金额。

查询同一请求的结算状态

保留响应中的 trace_id。待结算时可调用只读接口查询回执，不会重新生成或再次扣费；一次最多查询 25 个 Trace ID，结果按当前 API Key 或 OAuth 用户隔离。

GET /v1/billing/receipts?trace_id=<trace-id>
Authorization: Bearer <Vimox API Key 或 OAuth token>

{"data":[{"trace_id":"...","billing_status":"settled","consumed_vimoney_micros":2000000,"refunded_vimoney_micros":null,"remaining_vimoney":null,"unit":"ViMoney"}],"missing_trace_ids":[]}

同步与异步都是 OpenAI Images

图片模型请以 /v1/models 的 protocols 是否包含 openai-images 判断，并通过 /v1/images/generations 生图或 /v1/images/edits 编辑/传参考图。同步型号直接返回图片；AIHubCC 的异步型号仍从图片端点提交，返回 image.task、任务 ID 和 polling_url，然后轮询 /v1/videos/{id}?model={model}。只有需要主动把 gpt-image-2 / -1k 转为异步任务时才 POST /v1/videos；任务成功后由 Router 交付已持久化的 COS 图片地址。

vimox_usage · 本次消耗与剩余余额

所有使用 Vimox 身份完成的真实计费请求都会直接返回回执。扣费和退款先写入本地加密队列，再由后台完成远端结算；charge_pending / refund_pending 表示尚未确认。Router 不为请求回执重复查询钱包，remaining_vimoney 为 null；金额字符串用于展示，*_micros 整数用于计算，请保留 trace_id 对账。