Avante.nvim 项目中自定义 OpenRouter 供应商的配置问题解析

在 Avante.nvim 项目中配置 OpenRouter 作为自定义供应商时，开发者可能会遇到 404 Not Found 错误。本文将从技术角度分析这个问题的成因和解决方案。

问题现象

当开发者按照 OpenRouter 官方文档提供的 API 端点配置 Avante.nvim 时：

endpoint = "https://openrouter.ai/api/v1/chat/completions"

实际使用时会出现 404 Not Found 错误，提示 API 请求失败。

问题根源

经过分析，这个问题源于 Avante.nvim 与 OpenRouter API 交互方式的特殊性：

1. Avante.nvim 在内部会自动补全 API 路径，因此不需要在配置中包含完整的端点路径
2. 直接使用完整路径会导致路径重复，从而引发 404 错误
3. 这与直接使用 curl 命令测试 API 时的行为不同

正确配置方式

正确的 OpenRouter 供应商配置应该是：

vendors = {
    openrouter = {
        __inherited_from = "openai",
        api_key_name = "OPENROUTER_API_KEY",
        endpoint = "https://openrouter.ai/api/v1",  -- 注意这里只需要基础路径
        model = "deepseek/deepseek-chat",
    },
}

技术原理

Avante.nvim 的设计采用了以下技术实现：

1. 路径自动补全机制：框架会自动为 OpenAI 兼容的 API 添加 /chat/completions 路径
2. 供应商继承系统：通过 __inherited_from 可以复用已有供应商的请求逻辑
3. 端点规范化处理：框架会对配置的 endpoint 进行标准化处理，确保请求构造正确

最佳实践建议

1. 对于任何 OpenAI 兼容的 API，只需配置基础端点路径
2. 遇到 404 错误时，首先检查是否配置了多余的路径部分
3. 可以使用网络调试工具查看实际发出的请求 URL
4. 参考框架文档中的供应商配置示例

总结

理解框架的内部工作机制对于正确配置第三方 API 供应商至关重要。Avante.nvim 通过自动补全路径的设计简化了配置，但也要求开发者只需提供基础端点。这种设计既保持了配置的简洁性，又确保了与多种 API 后端的兼容性。