身份边界
API Key 接口使用 Authorization: Bearer oak_…；账户接口使用登录取得的会话 token；管理员和负责人还需对应角色。公开接口不要求 OneAster Key 或会话；Stripe webhook 与 NOWPayments IPN 仍须各自官方签名。内部服务接口不对外开放。
幂等和资金
POST /v1/chat/completions 与 POST /v1/tasks 必须提供 Idempotency-Key。已结算的非流式聊天可重放原结果；流式或其他已记录聊天返回409 request_already_recorded，通过响应头 X-OneAster-Request-ID 查询控制台请求日志或 GET /core/v1/requests/{id}。任务重放返回原任务 id；异输入返回409。超时、断线或 unknown 时查询原记录，不自动换 key 重发。
1 USD = 100 OneAster 积分；1 积分 = 10000 整数账务单位。OneAster 的 _micro 与 amount_usd_cents 使用不同单位的十进制整数字符串，网关积分内部精度四位；供应商原币种金额不能改写网关原报价。钱包只由 Core 写入；KIE 积分不是 OneAster 积分。