1. 认证
所有凭证共享同一个账户余额。密钥管理和 OAuth 细节见认证。
2. 调用端点
端点定义和参数遵循 OpenAPI 规范。
通过 MCP,智能体使用少量元工具即可工作,无需将数百个工具加载到上下文中:
search 和 list_categories 用于发现工具,get_details 用于查看输入参数,batch_quote 用于获取精确调用的报价,batch_use 用于一次执行最多 20 个调用。
3. 按用量付费
- 单一余额: 模型、数据 API、MCP 调用和 CLI 都从同一个预付钱包中扣费。在控制台 → Billing 充值。
- 模型按 token 计费(包括输入、输出以及提供商报告的缓存 token)。
- 数据 API 按请求计费:要么每次调用固定价格,要么根据请求消耗的内容(结果数、行数、页数或提供商额度)按量计费。
- 发现免费: 浏览文档、通过
/v1/models列出模型,以及 MCP 发现和报价(search、list_categories、get_details、batch_quote)不产生任何费用。你只需为实际执行的调用付费。 - 消费控制: 在控制台中为每个 key 设置消费限额,这是硬性上限。对于声明支持最高价格的端点,通过
X-AISA-Max-Price-USD传入上限:如果预估价格超出,网关会在调用任何提供商之前拒绝该请求。通过 MCP,batch_quote会在batch_use执行之前显示预估费用。两者都检查预估值,但不会限制最终实际费用。模型路由不适用此机制;请使用max_tokens和 key 的限额来约束模型消费。
AIsa 负责什么 vs. 你负责什么
对于有状态变更的操作(创建、更新、删除数据或花费资金)需格外谨慎:使用范围受限的 key,必要时要求用户明确确认,避免对失败调用自动循环重试。
何时使用 AIsa
当你的智能体或应用需要多个提供商时,AIsa 是理想选择:将 LLM 推理与实时数据混合使用、在不同模型系列之间切换,或在无需管理多份合同的情况下访问多个数据源。 如果你的工作负载始终只使用单一模型提供商,且你已与其建立了计费关系,直接连接该提供商可能更简单。下一步
通过 MCP 连接
三步快速为你的智能体设置 AIsa。
API Key 与首次调用
用 curl 发起你的第一个请求。