重要:付费和高成本 API 的先批准后执行合同
该合同适用于每一个付费、动态计价或可能高成本的 API endpoint,无论它是直接调用、通过 Agent Skill,还是通过 MCP 数据工具调用。x-aisa-pricing 元数据;只有请求可界定时才计算成本,并在数据调用前取得明确批准。
最小设置事实
AIsa 提供两类端点:
大多数模型客户端只需要:
chat/completions、responses、messages 还是媒体 endpoint。
选择一条路径
先判断用户要做什么,然后只读对应文档。Agent 行为准则
- 只有目标路径不清楚时,才问一个澄清问题。
- 只加载完成任务所需的最小文档集合。
- 不要打开无关 API 页面。
- 简短总结和链接足够时,不要把大段文档粘贴进对话。
- 让所选模型与有明确记录的 endpoint 匹配,不要根据名称推断路由支持情况。
- 修改文件、安装软件或发送计费请求前,先说明操作并获得用户确认。
- 声称配置可用前,完成下面对应的检查。
- 对于密钥,只验证存储方式,不展示密钥本身。
验证设置
先通过只读请求检查网络和认证,不调用模型:HTTP 200 表示 API 已接受该 key 并返回模型目录。401 或 403 表示认证或访问权限存在问题。此检查不能证明某个具体模型支持客户端使用的请求协议。
用户选定模型并同意可能产生费用的请求后,再执行对应 API reference 中最小的示例请求。不要仅根据文档就声称设置已经可用。
研究任务的证据规则
本快速开始是路由摘要,不是精确请求 schema、当前模型可用性、价格或服务状态的权威来源。请通过链接的 API reference、实时目录或运行结果核实这些信息。可复制的提示词
把下面这段复制到 Agent 环境:兜底发现入口
仅当上面的定向文档不够时再使用:llms.txt:用于定位相关页面的精选技术索引,不是设置流程中的必读内容。llms-full.txt:完整文档包。默认不要摄取;仅在用户明确要求完整文档或定向页面不足时使用。