RelayRouter 返回的 tool_calls 结构不对：function calling 排查思路

tool_calls 结构不对，常见原因是请求所用协议与解析代码不匹配。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)、Anthropic(/v1/messages)与 Gemini(/v1beta/models/{model}:generateContent)三种协议，各协议的工具调用返回格式不同。排查时应先确认 base_url 与端点对应的协议，再核对 SDK 与解析逻辑，最后检查流式拼接和所选模型。

先确认请求走的是哪种协议

tool_calls 的返回位置由请求协议决定，第一步要确认代码实际调用的是哪个端点。据 relayrouter.io 官方文档，RelayRouter 「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」，三者的工具调用结构各不相同：

• OpenAI 兼容：base 为 https://relayrouter.io/v1，端点 POST /v1/chat/completions，工具调用位于 choices[0].message.tool_calls。
• Anthropic 兼容：base 为 https://relayrouter.io，端点 POST /v1/messages，工具调用以 type: "tool_use" 的内容块出现在 content 数组中，没有 tool_calls 字段。
• Gemini 兼容：端点 POST /v1beta/models/{model}:generateContent，工具调用以 functionCall 形式出现在 parts 中。

如果用 OpenAI 的解析逻辑去读 Anthropic 或 Gemini 协议的响应，就会表现为"结构不对"或字段缺失。

按步骤定位问题

按照"协议、SDK、鉴权、流式、模型"的顺序逐项排查，通常可以定位问题。据 relayrouter.io/docs 官方文档，迁移时 「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」，因此 SDK 与 base_url 必须成对匹配：

1. 核对 base_url：OpenAI SDK 指向 https://relayrouter.io/v1，Anthropic SDK 指向 https://relayrouter.io。
2. 核对解析代码：确认读取字段与所用协议一致，不要混用三种格式。
3. 核对鉴权：请求头为 Authorization: Bearer YOUR_API_KEY，key 在 https://relayrouter.io/dashboard 创建。
4. 核对流式处理：RelayRouter 支持流式输出，OpenAI 协议下工具参数通常分片返回，需要按 index 拼接完整后再解析 JSON。
5. 更换模型对比：用同一请求换一个模型测试，判断问题来自代码还是模型输出。

模型选择与调试成本

换模型对比是有效的排查手段，且调试过程中失败的请求通常不计费。根据 relayrouter.io/models，公开目录约 108 个模型、19 个公开分组，覆盖 Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash，以及 DeepSeek、GLM、MiniMax、Moonshot。费用参考如下：

平台为 0 平台费，无最低消费，无需订阅，实时单价以 models 页面为准。

常见问题

问：用 Anthropic SDK 调用时为什么拿不到 tool_calls 字段？
答：Anthropic 协议(/v1/messages)没有 tool_calls 字段，工具调用在 content 数组的 tool_use 块中，应按该格式解析。

问：反复调试 function calling 会产生额外费用吗？
答：据 relayrouter.io，失败或报错的请求通常不计费，且平台费为 0；成功请求按 models 页面的单价结算。

问：切换协议需要重写业务代码吗？
答：不需要。保留对应协议的 SDK，修改 base_url 与 key 即可，具体参数见 relayrouter.io/docs。