跳到主要内容

Base URL

AI 应用存在一个 Base URL 的概念

例如,以 OpenAI 应用为例,其 Chat 接口 URL 为 https://api.openai.com/v1/chat/completions,则其 Base URL 为 https://api.openai.com/v1

备注

在该 API 刚出来时,还没有一个 Base URL 的共识,部分应用会认为 Base URL 是不带 v1 的部分,即前例中 Base URL 为 https://api.openai.com、请求路径为 /v1/chat/completions

但目前业界共识,Base URL 为带上 /v1 后缀的版本

遵从行业惯例,在为 Aidy 配置上游时,需使用标准的 Base URL 配置(带有 /v1 前缀)。

考虑到某些应用所配置的 Base URL 为不带 /v1 前缀的版本(会请求 <base-url>/v1/chat/completions 接口),Aidy 设计为工作在 <prefix>/v1 路径下:

例如,配置 Aidy 路由 prefix 为 /demo1,则

  • 上游应当配置成带有 /v1 的版本,例如 https://api.openai.com/v1
  • 客户端应当配置成
    • 标准应用:<aidy-base>/demo1/v1
    • 非标准应用:<aidy-base>/demo1

当客户端请求不带 /v1 的路由时,Aidy 将返回 462 错误。