Skip to Content
产品概览核心概念

核心概念

把文档、请求和控制台中反复出现的术语放进同一张关系图里,后续排查问题时才能知道应该看哪一层。

先记住这条主线:账户拥有 API Key,客户端带着 Key 请求网关,请求指定模型,平台组织渠道,执行结果消耗额度并形成计费记录。

身份与访问

概念它代表什么使用时最重要的判断
账户用户或团队在平台中的主体账户决定可见资源、总额度和管理范围。
API Key / 令牌账户下的一把访问凭证只有完整密钥可鉴权;不同应用和环境应拆分 Key。

API Key 不是账户本身。一个账户可以创建多把 Key,它们可以有不同名称、有效期和额度,但仍受账户总额度与权限范围影响。

请求与路由

概念它代表什么调用侧应该关注什么
网关GGPU API 的统一入口使用正确 Base URL 和接口路径。
模型请求希望调用的能力对象填写账号当前可用的准确模型名称。
Provider / 渠道平台组织上游服务的方式普通调用侧通常关注模型,渠道由平台配置与调度。

模型名称和渠道名称不是一回事。模型描述“要什么能力”,Provider 或渠道更接近“这次能力由哪里提供”。

执行方式

方式返回方式适合的任务
同步请求在一次请求中等待并返回结果响应时间可控的普通调用。
流式响应在同一连接中分块持续输出文本较长、希望尽快展示首段内容的对话。
异步任务先创建任务,再查询状态和结果图片生成或其他耗时、需要跟踪状态的流程。

流式与异步解决的是不同问题:流式仍是一条持续返回的请求连接;异步则把执行过程变成一个可后续查询的任务。

额度与计费

概念回答的问题常见层级
额度还能不能继续使用账户总额度、单 Key 额度。
计费项这次使用如何形成费用记录按模型、能力或平台规则计算。
限流当前是否允许继续以这个速率请求可能与 Key、账户或接口状态有关。

额度与计费有关联,但不是同一个概念。额度控制可用上限,计费描述每次使用如何记录;任何一层额度触顶都可能让请求受到限制。

一次请求如何串起这些概念

账户创建 API Key

凭证属于账户,但可以按应用、环境或成员拆分,并设置单独的有效期与额度。

客户端请求网关

客户端把完整 Key 放进鉴权请求头,并把请求发送到统一 Base URL。

请求指定模型

模型名称决定希望调用的能力;平台再根据当前配置组织 Provider 或渠道。

平台执行并返回

普通请求同步返回,长文本可以流式输出,耗时流程则可能创建异步任务。

系统记录消耗

调用影响账户或 Key 的可用额度,并根据对应规则形成用量和计费记录。

最容易混淆的四组概念

不要混为一谈核心区别
账户 vs. API Key账户是主体,Key 是主体下可轮换、可限制的访问凭证。
模型 vs. 渠道模型描述能力,渠道描述平台如何连接能力来源。
同步 vs. 异步同步在当前请求返回结果,异步先返回任务并由调用方继续查询。
额度 vs. 计费额度限制还能用多少,计费记录一次使用如何产生费用。

继续阅读