New API使用杂记

前言

New API 是一个AI网关集成系统,可以用来统一各大平台的接口。但是因为 New API 更新迭代速度较快,内容较多且混乱,文档更新速度远远赶不上系统更新速度等原因,故书写了此篇文章。主要是将碰到的一些不太容易理解或者文档里没说明纯需要你靠猜才能配置的东西做了一些说明。
请注意内容具有极强的时效性,可能会因为New API更新而导致错误或者失效!

关于模型重定向

新版本(0.9.25)已经增加了一定的模型重定向提示便于理解。
简短说明:你需要在渠道的模型中添加你重定向后的模型名称进去以后才能正常使用。
主要操作是在渠道管理页面里面,如下图示例,假设我们希望将claude-sonnet-4-5-20250929重定向名称为claude-sonnet-4-5这样我们在调用模型的时候就可以使用claude-sonnet-4-5这个名称来调用了。下面的模型重定向很好写,前面写重定向后的名称,后面写他的实际模型名称但这里必须要注意你需要将重定向后的名称添加到模型里面才行,否则会提示你该分组下没有这个模型。你需要在自定义模型名称内填入claude-sonnet-4-5点击填入。在这个操作过后,你可以删除掉模型里面的claude-sonnet-4-5-20250929了,这样就只能看到重定向后的模型名称了。
New API使用杂记
你在使用日志里面看到如下图的样式,则代表设置成功了。

关于 auto 分组的使用

简短说明:你需要在用户可选分组里面添加 auto 分组才可以使用。
这部分设置在系统设置->分组与模型定价设置->分组倍率设置,在最底下有一个自动分组auto,从第一个选择开始,在这里可以设置当使用auto分组的时候会从那个分组开始选择。设置完后你会发现这玩意没用啊……这是因为这个分组名称叫作"auto",你需要在"用户可选分组"里面将这个分组添加进去才会显示。否则你底下的填写什么都是没用的,他只会使用用户默认分组。坑死了=、=

关于用户分组

上面那个对于 auto 分组的解释有这样一句 "创建令牌默认选择auto分组,初始化令牌也将设为auto(否则留空,为默认用户分组)"这里的默认用户分组又是什么呢?这个设置在用户管理里面,你就会看到每个用户的分组了。比如这里你设置为 vip 他们他默认创建令牌的时候默认使用 vip 分组的模型而不是 default 。

ChatCompletions转Responses兼容

在 系统设置 -> 模型相关设置 -> 全局设置 -> ChatCompletions→Responses 兼容配置
选择填入模板可以查看具体的样子,有两种:
指定渠道:

{
  "enabled": true,
  "all_channels": false,
  "channel_ids": [
    136
  ],
  "channel_types": [
    1
  ],
  "model_patterns": [
    "^gpt-4o.*$",
    "^gpt-5.*$",
    ".*codex.*"
  ]
}

这是我改过后的样子,参数解释

  • enabled :开关
  • all_channels :是否是全渠道开启,为否是为指定渠道开启
  • channel_ids :指定开启哪些渠道,填入渠道 ID
  • channel_types :渠道类型,这个是你点开渠道里面那个类型,比如 1 代表 OpenAI3 代表 Azure,在 https://raw.githubusercontent.com/QuantumNous/new-api/main/constant/channel.go 这里可以查看到,这个参数可以删除掉不写,或为空。
  • model_patterns :匹配的模型,必填,支持正则表达式,必须填写,否则不起作用。这里我增加了 codex 的匹配。

全渠道

{
  "enabled": true,
  "all_channels": true,
  "model_patterns": [
    "^gpt-4o.*$",
    "^gpt-5.*$"
  ]
}

这个就简单了,但是模型还是必须得写的,同时要注意这个是对所有渠道都起作用的,可能有的渠道会不兼容这个。


参考文章

订阅评论
提醒
用户头像

0 评论
最旧
最新 最多投票