核心概念
把文档、请求和控制台中反复出现的术语放进同一张关系图里,后续排查问题时才能知道应该看哪一层。
先记住这条主线:账户拥有 API Key,客户端带着 Key 请求网关,请求指定模型,平台组织渠道,执行结果消耗额度并形成计费记录。
身份与访问
API Key 不是账户本身。一个账户可以创建多把 Key,它们可以有不同名称、有效期和额度,但仍受账户总额度与权限范围影响。
请求与路由
模型名称和渠道名称不是一回事。模型描述“要什么能力”,Provider 或渠道更接近“这次能力由哪里提供”。
执行方式
流式与异步解决的是不同问题:流式仍是一条持续返回的请求连接;异步则把执行过程变成一个可后续查询的任务。
额度与计费
额度与计费有关联,但不是同一个概念。额度控制可用上限,计费描述每次使用如何记录;任何一层额度触顶都可能让请求受到限制。
一次请求如何串起这些概念
账户创建 API Key
凭证属于账户,但可以按应用、环境或成员拆分,并设置单独的有效期与额度。
客户端请求网关
客户端把完整 Key 放进鉴权请求头,并把请求发送到统一 Base URL。
请求指定模型
模型名称决定希望调用的能力;平台再根据当前配置组织 Provider 或渠道。
平台执行并返回
普通请求同步返回,长文本可以流式输出,耗时流程则可能创建异步任务。
系统记录消耗
调用影响账户或 Key 的可用额度,并根据对应规则形成用量和计费记录。