查询模型刊例价

接口路径

GET /api/open/models/list-prices

请求参数

字段	类型	是否必传	说明	限制条件
enterprise_id	int	否	企业 ID	传入按该企业可访问模型过滤，不传按当前登录个人过滤
model_name	string	否	模型名精确匹配	多个用英文逗号分隔，须与返回的 model_name 一致
keyword	string	否	模型名模糊搜索
page	int	否	页码	从 1 开始，默认 1；兼容别名 p
page_size	int	否	每页条数	默认 20，最大 500

请求示例

GET 'https://neolink.com/backend/api/open/models/list-prices?enterprise_id=1001&keyword=gpt&page=1&page_size=20'
GET 'https://neolink.com/backend/api/open/models/list-prices?model_name=gpt-4o,doubao-seed-2-1-pro-260628&page=1&page_size=20'

返回信息

成功时 HTTP 200，包络：{ "success": true, "message": "", "data": { ... } }。

「是否必传」指该字段在成功响应中是否一定出现（否 = 可能省略，常见于 omitempty）。

字段	类型	是否必传	说明
success	bool	是	请求是否成功；成功 true；失败 false
message	string	是	状态消息；成功多为空；失败为当前语言错误说明
data	object	否	业务数据；仅成功时返回，详见下表

data（分页）

字段	类型	是否必传	说明
items	object[]	是	本页模型刊例价列表
total	int	是	过滤后的总条数
page	int	是	当前页码
page_size	int	是	当前每页条数

items[] 字段

字段	类型	是否必传	说明
model_name	string	是	模型广场的模型名称
supported_endpoint_types	string[]	是	支持的端点类型；无则为 []
max_prompt_tokens	int	是	最大输入 tokens
max_completion_tokens	int	是	最大输出 tokens
model_ratio_configured	bool	是	倍率是否已显式配置
unit	string	是	固定为 "M tokens"，仅解释同级 *_ratio_* 单价的计量单位
scenario_status	string	否	场景表状态：ok / partial / unsupported；无场景能力时可能省略
scenario_dims	object[]	否	计费维度定义；结构见下表
scenarios	object[]	否	各档场景具体价格；结构见下表
model_ratio_usd / model_ratio_cny	string	否	输入刊例价（四位小数）；有可用场景表时通常省略
completion_ratio_usd / completion_ratio_cny	string	否	输出刊例价；隐藏输出或有场景表时省略
cache_ratio_usd / cache_ratio_cny	string	否	缓存命中/读取价；未配置或有场景表时省略
create_cache_ratio_usd / create_cache_ratio_cny	string	否	缓存创建/写入价；未配置或有场景表时省略
image_ratio_usd / image_ratio_cny	string	否	图片相关单价；未配置则省略
audio_ratio_usd / audio_ratio_cny	string	否	音频输入相关单价；未配置则省略
audio_completion_ratio_usd / audio_completion_ratio_cny	string	否	音频输出相关单价；未配置则省略

scenario_status 取值

值	含义	建议
ok	维度可完整枚举	直接展示场景表
partial	部分因子按基准固定或取值域为推断	可展示，需知表不覆盖全部真实请求组合
unsupported	无法推导	scenarios 为空，走路径 B

scenario_dims[]

字段	类型	说明
key	string	维度键，如 extra:resolution、num:input_len
label	string	展示名，如「分辨率」
values	object[]	该维度可选值列表；每项含 value（机器取值，如 1080p）与 label（展示文案，如 1080P）
inferred	bool	取值域为推断所得时为 true
vars	string[]	仅输入长度轴常见：len（完整上下文）/ p（计费输入）

scenarios[]

字段	类型	说明
tier	string	档位名
match	object	维度键 → 命中取值列表
lines	object[]	该档计价线
per_call_usd / cny	string	每次固定费（有则返回）
per_call_usd_raw	number	固定费未舍入美元值
free	bool	整场免费

scenarios[].lines[]

字段	类型	说明
key	string	如 p / c / out_sec
label	string	如「输入」「输出」
unit	string	本线计量单位（场景路径以此为准）
amount_usd / amount_cny	string	四位小数展示价
amount_usd_raw	number	未舍入美元值（极低单价用）
output	bool	是否输出侧
segments	object[]	分段计价（可选）
free	bool	该项被显式配为免费

scenarios[].lines[].segments[]

字段	类型	说明
from	number	段起点
to	number	段终点；末段可能省略
unbounded	bool	末段无上界
amount_usd / amount_cny	string	该段单价
amount_usd_raw	number	未舍入美元值

怎么拿美元 / 人民币价格（必读）

路径 A：有可用场景表（优先）

判断：scenario_status 为 ok 或 partial，且 scenarios 非空。

• 用 scenario_dims 渲染筛选项
• 用 scenarios[].match 匹配当前维度取值
• 读命中档的 lines[].amount_usd / amount_cny
• 单位看 lines[].unit（如 元/百万tokens、元/秒、元/张、元/百万字符），不要用顶层 unit
• 此时 不会 下发 model_ratio_* / cache_ratio_* 等，避免双真相

路径 B：无可用场景表（标准按量）

判断：无可用场景，且 model_ratio_configured == true，并出现 model_ratio_usd 等字段。

• 输入：model_ratio_usd / model_ratio_cny
• 输出：completion_ratio_usd / completion_ratio_cny（有则展示）
• 缓存命中/读取：cache_ratio_usd / cache_ratio_cny（有则展示）
• 缓存创建：create_cache_ratio_usd / create_cache_ratio_cny（有则展示）
• 图片/音频：image_ratio_* / audio_ratio_* / audio_completion_ratio_*（有则展示）
• 单位：顶层 unit = "M tokens"（每百万 tokens）
• 金额：四位小数字符串，如 "5.0000"；CNY 已按系统汇率折算

路径 C：无价格

model_ratio_configured == false 且无可用场景 → 无 *_ratio_*、无可用 scenarios。表示未对外发布可展示刊例价（勿当成免费）。

返回示例

标准按量（路径 B）

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "model_name": "doubao-seed-2-1-pro-260628",
        "supported_endpoint_types": ["openai"],
        "max_prompt_tokens": 128000,
        "max_completion_tokens": 16384,
        "scenario_status": "unsupported",
        "scenarios": [],
        "model_ratio_usd": "0.8571",
        "model_ratio_cny": "6.0000",
        "completion_ratio_usd": "4.2857",
        "completion_ratio_cny": "30.0000",
        "cache_ratio_usd": "0.1714",
        "cache_ratio_cny": "1.2000",
        "create_cache_ratio_usd": "0.0024",
        "create_cache_ratio_cny": "0.0170",
        "model_ratio_configured": true,
        "unit": "M tokens"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}

有场景表（路径 A，节选）

{
  "model_name": "doubao-seedance-2-0-260128",
  "scenario_status": "ok",
  "scenario_dims": [
    {
      "key": "extra:resolution",
      "label": "分辨率",
      "values": [{ "value": "720p", "label": "720p" }]
    }
  ],
  "scenarios": [
    {
      "tier": "480p/720p-不含视频输入",
      "match": { "extra:resolution": ["480p", "720p"] },
      "lines": [
        {
          "key": "c",
          "label": "输出",
          "unit": "元/百万tokens",
          "amount_usd": "6.5714",
          "amount_cny": "46.0000",
          "amount_usd_raw": 6.5714285714,
          "output": true
        }
      ]
    }
  ],
  "model_ratio_configured": true,
  "unit": "M tokens"
}

其它说明

• 列表按发布时间/创建时间倒序，过滤口径对齐 /api/pricing/accessible。
• 刊例价 不含 用户/企业分组折扣。
• 失败一般为鉴权失败（如 AK/SK 401）；业务成功体仍为 success 包络。