Model groups & pricing

DimiLinks 上不同模型属于不同分组，分组直接决定最终费用。调用前的硬约束：

同一个模型只在固定的若干分组里开放。例如 claude-opus-4-8 只在 Claude 分组里能调，不存在「default 分组也能跑 Claude」。
你的 API Key 自身有「可用分组」字段，必须与目标模型的可用分组有交集，调用才会通过。
同一段提示词在不同模型 / 不同分组之间费用不能线性外推：我们按「官方价 × 模型倍率 × 分组倍率」结算，组合差异可能达到几十倍。

不要硬编码倍率，分组与价格随时可能调整。请把 GET /api/pricing 的返回结果作为运行时事实源。

权威接口

curl https://api-direct.dimilinks.com/api/pricing

该接口无需登录即可访问，返回当前线上的全部分组、可用分组说明、模型清单和倍率：

{
  "success": true,
  "pricing_version": "a42d372ccf0b5dd13ecf71203521f9d2",
  "group_ratio": {
    "default": 1,
    "open ai 特价": 0.5,
    "claude 特价": 0.3,
    "claude-max": 0.8,
    "gpt-image-2": 1
  },
  "usable_group": {
    "default": "",
    "open ai 特价": "open ai 自有号池",
    "claude 特价": "claude 自有号池",
    "claude-max": "claude 满血渠道",
    "gpt-image-2": ""
  },
  "auto_groups": [],
  "supported_endpoint": {
    "openai":      { "path": "/v1/chat/completions",   "method": "POST" },
    "anthropic":   { "path": "/v1/messages",           "method": "POST" },
    "image_generation": { "path": "/v1/images/generations", "method": "POST" },
    "image_edits": { "path": "/v1/images/edits", "method": "POST" }
  },
  "data": [
    {
      "model_name": "gpt-5.5",
      "enable_groups": ["open ai 特价", "default"],
      "model_ratio": 2.5,
      "completion_ratio": 6,
      "cache_ratio": 0.1,
      "quota_type": 0,
      "model_price": 0,
      "supported_endpoint_types": ["openai"]
    },
    {
      "model_name": "claude-opus-4-8",
      "enable_groups": ["claude 特价", "claude-max"],
      "model_ratio": 2.5,
      "completion_ratio": 5,
      "cache_ratio": 0.1,
      "quota_type": 0,
      "model_price": 0,
      "supported_endpoint_types": ["anthropic", "openai"]
    },
    {
      "model_name": "gpt-image-2",
      "enable_groups": ["gpt-image-2", "default"],
      "model_ratio": 0,
      "completion_ratio": 0,
      "cache_ratio": null,
      "quota_type": 1,
      "model_price": 0.08,
      "resolution_options": [
        { "resolution": "1k", "model_price": 0.08, "max_n": 1 },
        { "resolution": "2k", "model_price": 0.15, "max_n": 4 },
        { "resolution": "4k", "model_price": 0.30, "max_n": 4 }
      ],
      "supported_endpoint_types": ["image_generation", "image_edits"]
    }
  ]
}

字段含义

字段	含义
`group_ratio`	当前所有分组的倍率字典，唯一权威来源
`usable_group`	分组的对外说明文案，可用于文档 / UI 展示
`auto_groups`	后端「自动分组」白名单；只有命中此处的分组才允许通过自动选择落到具体模型上
`data[].enable_groups`	该模型支持的分组列表，调用必须命中其中之一
`data[].model_ratio`	输入 token 倍率（相对官方基准）
`data[].completion_ratio`	输出 token 倍率（相对 `model_ratio` 的乘数）
`data[].cache_ratio`	缓存命中部分的倍率，`null` 表示该模型不区分缓存
`data[].quota_type`	`0` 按 token 计费，`1` 按次计费
`data[].model_price`	`quota_type=1` 时的单次价格
`pricing_version`	计费快照版本；用于客户端缓存键，发生变化时需要重新拉取

调用方如何选分组

请求里有两种选分组的方式：

不传 group（推荐）：后端取「API Key 可用分组 ∩ 模型 enable_groups」，再按 auto_groups 与内部优先级选一个。这是默认链路，对绝大多数调用方来说够用。
显式传 group：在请求体里加 "group": "claude 特价" 等。前提是该分组同时存在于 API Key 可用分组与模型 enable_groups 中，否则会返回 403 model_not_allowed。

curl https://api-direct.dimilinks.com/v1/chat/completions \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role": "user", "content": "你好"}],
    "group": "claude 特价"
  }'

只有当一把 API Key 同时具备多个目标分组、且业务上需要稳定走某一个时，才需要显式指定 group。

计费公式

按 token 计费的模型（quota_type = 0）：

input_cost  = input_tokens         × model_ratio                    × group_ratio
output_cost = output_tokens        × model_ratio × completion_ratio × group_ratio
cached_cost = cached_input_tokens  × model_ratio × cache_ratio      × group_ratio   (cache_ratio 不为 null 时启用)
total_cost  = input_cost + output_cost + cached_cost

按次计费的模型（quota_type = 1）：

total_cost = model_price × group_ratio × n

n 为本次任务实际产出的图片 / 视频张数（图片接口里就是请求体中的 n）。

估算示例

claude-opus-4-8 在 claude 特价 分组，输入 1k token、输出 500 token：

model_ratio = 2.5，completion_ratio = 5，group_ratio = 0.3
input = 1000 × 2.5 × 0.3 = 750
output = 500 × 2.5 × 5 × 0.3 = 1875
total ≈ 2625（系统内部 quota，按账户 quota_per_unit 折算成显示货币）

gpt-5.5 在 default 与 open ai 特价 分组对比：

default：group_ratio = 1，按 model_ratio 2.5 × completion_ratio 6 全额结算。
open ai 特价：group_ratio = 0.5，最终费用是 default 分组的一半。

gpt-image-2 异步出 1 张 2K 图片：

2K 档 model_price = 0.15，group_ratio 取 gpt-image-2 = 1 或 default = 1，单次费用 0.15。1K / 4K 档分别读取 resolution_options，不要套用 2K 价格。

工程化建议

启动时拉一次 GET /api/pricing，按模型建立 model_name → { enable_groups, model_ratio, completion_ratio, cache_ratio, quota_type, model_price } 的索引；用 pricing_version 做缓存键。
在 UI 上展示某模型可用分组时，直接读 data[].enable_groups 与 usable_group 文案，不要自己维护一份硬编码映射。
估算费用时务必同时考虑 model_ratio、completion_ratio、cache_ratio、group_ratio 四项，缺一项都会算偏。
看到 403 model_not_allowed：先检查 API Key 可用分组是否覆盖了目标模型的 enable_groups；临时绕过的方式是把 group 显式指向当前 Key 实际拥有的那个分组。

基础

对话 / Chat

图片 / gpt-image-2

视频 / grok-imagine-video

IDE 与 CLI 接入

权威接口

字段含义

调用方如何选分组

计费公式

估算示例

工程化建议

​权威接口

​字段含义

​调用方如何选分组

​计费公式

​估算示例

​工程化建议

权威接口

字段含义

调用方如何选分组

计费公式

估算示例

工程化建议