跳转到主要内容
GET
模型价格查询

接口信息

此接口没有请求参数,只需携带认证头。

1. 认证

所有请求都必须在 HTTP Header 中携带 Bearer 凭证。支持两种凭证,任选其一:
以下情况视为认证失败:凭证缺失或错误、凭证已删除或禁用、账号已禁用。

2. 通用响应结构

业务状态码

请以响应体中的 code 判断请求是否成功。

金额格式

  • 所有金额都以**美元(USD)**表示,类型为 string,避免浮点精度丢失。
  • 余额类金额固定保留 4 位小数,例如 "986.9275"。
  • 模型单价按实际价格输出,不补末尾的 0,例如 "40"、"2.5"、"0.00075"。

3. 模型价格查询

3.1 两种凭证的查询范围

3.2 data 字段

3.3 groups:分组与折扣

auto 分组按实际命中的分组计费,它的 ratio 仅供参考。

3.4 supportedEndpoint:端点类型

键为端点类型,值为该类型对应的请求方式和路径,例如:
只包含本次返回的模型用到的端点类型。每个模型的 supportedEndpointTypes 列出它支持哪些端点类型,可以在这里查到对应的请求路径。

3.5 models:模型与价格

3.6 prices:价格项说明

按 token 计费(单位:USD / 百万 token): 按次、按秒、按张计费: 阶梯计费的价格项:在上面的价格项后加上档位后缀。文本输入的价格项会省略 text 前缀,写作 inputTokens。 数量单位:K 表示千 token,M 表示百万 token。例如 272K 表示 272,000 token,1M 表示 1,000,000 token。

3.7 tierBasis:阶梯划分依据

同样是 Lte272K,不同模型判断档位时看的数量可能不同,tierBasis 用来说明依据是什么: 计费规则:
  1. 整次请求按一个档位计费:先根据本次请求的数量确定档位,然后这次请求的输入、输出、缓存等全部按该档位的单价计费,不分段累进。
    • 例:某模型 tierBasis = ["context"],一次请求的上下文为 300K,命中 Gt272K 档,则这次请求的输入、输出、缓存都按 xxxGt272K 的单价计费。
  2. 按上下文长度和按输入的区别在于缓存:
    • 例:一次请求包含 200K 新输入和 100K 缓存命中。按上下文长度统计为 300K,命中 Gt272K;按输入统计只有 200K,命中 Lte272K。
  3. 多个依据同时出现(如 ["input", "output"])时,需要同时满足各项条件才命中对应档位。
  4. 按时段计费有两种形式:
    • prices 中同时给出 xxxPeak 和 xxxOffPeak 两组价格,分别对应高峰和非高峰时段。
    • prices 中只给出基础价,高峰时段在基础价上乘以系数。具体时段和系数请咨询客户经理。

3.8 billingType:计费类型

pricingConfig 的结构因模型而异,请以实际返回为准。

3.9 实际单价计算

例:使用 ratio = 0.86 的分组调用某模型,该模型 textInputTokens 为 "8",则实际输入单价为 8 × 0.86 = $6.88 / 百万 token。

3.10 响应示例

以下示例只截取了部分内容:
使用 API 密钥调用时,groups 只包含该密钥的分组,models 也相应只包含该分组下可用的模型,另外会多返回一个 tokenName 字段。

4. 调用示例


5. 注意事项

  1. 数据刷新:模型价格调整后,最长约 1 分钟生效。
  2. 价格为原价:prices 返回的是模型原价,实际扣费需乘以所用分组的 ratio。
  3. 以实际扣费为准:本接口用于查询和预估,最终费用请以账单为准。
  4. 妥善保管凭证:系统访问令牌可以查询整个账号的信息,请勿泄露;如果只需要查询某个密钥的额度,建议使用对应的 API 密钥调用。