快速开始

查询模型定价

文档最后更新于 2026年10月16日 02:29

登录后读取全部在售模型的计费表达式、价格系数与支持的调用协议。

端点:GET /api/pricing

返回定价表里全部模型的计费表达式、价格系数、支持的调用协议与生效分组。本接口需要登录:请求头带 Authorization: Bearer <登录后的 access_token>(控制台个人访问令牌也可)。sk- 调用令牌不能用于本接口;要取可调用模型列表请用带 sk- 的 GET /v1/models。公开价格见 模型广场。

注意路径是 /api/pricing。/v1/models/pricing 不是定价接口 —— 它会被解析成「查询 ID 为 pricing 的模型」,带 sk- 时返回 HTTP 200 但响应体是 error 对象(code 为 model_not_found),不含任何价格;请以响应体里有没有 error 判断,不要只看状态码。
定价表与可调用模型列表并不一一对应:模型是否可调用以 列出模型 为准,价格以本接口为准。历史上架过的模型可能仍在定价表里留有表达式。

请求

需登录:Authorization: Bearer <access_token>(或控制台个人访问令牌),无请求体。

参数

无。

响应

json
{
  "success": true,
  "data": [
    {
      "model_name": "claude-sonnet-5",
      "quota_type": 0,
      "model_ratio": 37.5,
      "model_price": 0,
      "owner_by": "",
      "completion_ratio": 1,
      "enable_groups": ["default", "统一调用分组"],
      "supported_endpoint_types": ["openai", "anthropic"],
      "billing_mode": "tiered_expr",
      "billing_expr": "tier(\"base\", p * 0.24 + c * 1.2 + cr * 0.024 + cc * 0.3 + cc1h * 0.48)",
      "pricing_version": "a42d372c…"
    }
  ],
  "vendors": [
    { "id": -1005, "name": "DeepSeek", "icon": "DeepSeek.Color" }
  ],
  "group_ratio": { "统一调用分组": 1 },
  "usable_group": { "统一调用分组": "…" },
  "supported_endpoint": {
    "openai": { "path": "/v1/chat/completions", "method": "POST" },
    "anthropic": { "path": "/v1/messages", "method": "POST" }
  },
  "pricing_version": "…"
}
字段说明
data[].model_name调用时使用的模型 ID(与 列出模型 的 id 一致)
data[].quota_type计费方式:0 按 token、1 按次
data[].billing_expr计费表达式,决定实际扣费金额。见下方「怎么读计费表达式」
data[].model_ratio / model_price旧版计费字段,本站计费以 billing_expr 为准,这两个值不参与计算
data[].enable_groups该模型生效的分组。本站所有调用都在 统一调用分组 下
data[].supported_endpoint_types该模型支持的调用协议,取值 openai、anthropic、gemini、openai-response、image-generation、openai-video。协议对应的端点见 API 概览
vendors[]厂商字典,id 与 data[].vendor_id 对应
group_ratio分组倍率,本站恒为 1,对价格没有影响
pricing_version定价表版本号,价格变动时会变化

怎么读计费表达式

billing_expr 里 token 型变量(p / c / cr / cc / cc1h)的单位是美元 / 每百万 token,且已经包含本站的实收折扣;图片模型的表达式按张计价(fixed(...) × image_count),视频模型按秒计价(u("seconds") × 每秒价),单位不同、口径一致:

变量含义
p输入 token(未命中缓存的部分)
c输出 token
cr命中缓存读取的 token
cc写入缓存(5 分钟)的 token
cc1h写入缓存(1 小时)的 token
len上下文长度,用于分档计价

示例 tier("base", p * 0.24 + c * 1.2 + cr * 0.024) 表示:输入 $0.24 / 百万 token,输出 $1.2 / 百万 token,缓存读取 $0.024 / 百万 token。带 len <= 272000 ? tier("le272K", …) : tier("gt272K", …) 的是长上下文分档,超过阈值后按另一组系数计价。

价格会随上游调价,历史账单以实际扣费为准,不要用当前表达式反推历史账单。计费规则与折扣细节见 常见问题。

示例

本页接口与模型无关,示例用 https://acapi.top;换成国内通道 https://api.acapi.top 同样可用,两个地址均可用,见 调用地址。

bash
curl https://acapi.top/api/pricing \
  -H "Authorization: Bearer $CA_ACCESS_TOKEN"

错误

未登录(没带凭证、凭证过期,或带的是 sk- 调用令牌)返回 401,响应体不是 error 对象,而是:

json
{
  "code": "AUTH_UNAUTHORIZED",
  "message": "Unauthorized, invalid access token",
  "success": false
}

登录态过期时先刷新登录再重试一次。

共 30 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。