供应商 Endpoint 强制添加 /v1 导致无法兼容部分供应商

[sunxyw]

部分 openai-compatible 供应商，如火山引擎、Kimi Code 等，使用自定义的版本号后缀，而非 openai 广泛使用的 v1 后缀。

当前实现会为 Endpoint 强制添加 /v1 后缀，这会导致无法兼容这部分供应商。

应该允许用户完全自定义 Endpoint，而非强制添加后缀。

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

---

⚠️ Possible Duplicate Issue

• [bug] 用 codex (Response API) 時, 如果base_url本身不需要有v1的, 都會被加上v1導致請求出錯 #139

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[ding113]

您好，只需要将后面的 /chat/completions 部分完整输入在端点字段中，系统会自动处理。

[github-actions]

感谢反馈此问题。

问题分析：

根据代码库分析，当前实现确实存在强制添加 /v1 前缀的行为，这会导致使用自定义版本号后缀的供应商（如火山引擎的 /v3、Kimi Code 等）无法正常工作。

受影响的代码：

1. src/app/v1/_lib/url.ts (第 49 行) - URL 拼接逻辑中硬编码了 /v1 前缀：

   const requestRoot = `/v1${endpoint}`; // 假设所有请求都使用 /v1 前缀

2. src/app/v1/_lib/url.ts (第 111-113 行) - openai-compatible 供应商的端点预览中硬编码了 /v1 路径：

   "openai-compatible": [
     { key: "openaiChatCompletions", path: "/v1/chat/completions" },
     { key: "openaiModels", path: "/v1/models" },
   ]

现有的智能检测逻辑：

系统已经实现了智能 URL 检测功能（参见 buildProxyUrl 函数的注释，Issue #139 相关修复），可以：

• 检测 base_url 是否已包含完整路径
• 避免重复拼接已存在的端点路径

但是，这个逻辑假设请求路径总是使用 /v1 前缀（如 /v1/chat/completions），因此无法处理：

• 供应商使用 /v3/chat/completions 等自定义版本号的情况
• 用户希望完全自定义端点路径的场景

建议的解决方案：

允许用户完全控制端点路径，有几种可能的实现方式：

1. 方案 A： 改进 URL 检测逻辑，支持任意版本号前缀（/v1, /v2, /v3 等）
2. 方案 B： 允许用户在 base_url 中包含完整路径（如 https://api.volcengine.com/v3），系统仅拼接端点（如 /chat/completions）
3. 方案 C： 提供配置选项，让用户选择是否自动添加版本号前缀

相关历史：

类似问题在 Issue #139 中被报告并部分修复，当时主要解决了 /responses 端点被重复拼接的问题。但该修复仍假设使用标准的 /v1 前缀。

---

Automated response from Claude AI

[github-actions]

此问题是 #139 的重复。

为什么这是重复问题:

两个问题描述的是完全相同的根本原因和症状：

1. 相同的根本原因: CCH 会强制为供应商的 base_url 添加 /v1 后缀
2. 相同的影响: 导致使用自定义版本号后缀（如火山引擎、Kimi Code）或不需要版本号的供应商无法正常工作
3. 相同的解决方案: 两个问题都建议允许用户完全自定义 Endpoint，而非由系统强制添加后缀

原始问题: #139

虽然 #139 已被关闭，但根据讨论记录，维护者表示会在后续版本修复，但该问题似乎尚未实际解决。建议在 #139 中继续跟进进度。

如果您认为这不是重复问题，请说明两者的区别，我们将重新打开此 issue。

---

Automated duplicate detection by Claude AI

[sunxyw]

您好，只需要将后面的 /chat/completions 部分完整输入在端点字段中，系统会自动处理。

感谢你的及时解答 👍

可以考虑增加相关描述以避免误解。随着使用自定义后缀的供应商增多，这应该会成为常见问题。