API Error: 400 messages...... 解决方案

完整报错：

API Error: 400 messages.184.content.1: Input tag ‘document’ found using ‘type’ does not match any of the expected

解决方案：

这个错误的意思是，你发给 Kimi API 的消息里，有一个 content 部分的 type 被标成了 document，但 Kimi API 目前不支持这个类型。

🤔 为什么会这样？

这个错误常见于使用 Claude Code 或类似工具，通过 Kimi 提供的 Anthropic 兼容接口（api.moonshot.cn/anthropic）来调用 Kimi 模型时。

问题的根源在于，Kimi 的这个 Anthropic 兼容接口，并没有实现 Claude 原始接口中所有的 content 类型。你使用的客户端（如 Claude Code）在构造消息时使用了 document 类型，但 Kimi 的接口无法识别，所以就报错了。

✅ 怎么解决？

这里有几种方法可以尝试：

• 换用专用接口（最推荐）：Kimi 官方提供了一个为编码场景优化的专用接口：https://api.kimi.com/coding/。尝试将你的客户端（如 Claude Code）的 base_url 改成这个地址。

• 检查并调整 content 类型：检查你发送的请求，把 type 为 document 的 content 部分，改成 Kimi 支持的 type，例如 text。

• 通过中间层转发（如 OpenRouter）：有开发者反馈，通过 OpenRouter 这样的中间层 API 来调用 Kimi，可以解决 document 类型不被支持的问题。

• 使用 Kimi 官方 SDK 和文件上传接口：如果你需要让 Kimi 处理文档，最佳实践是使用 Kimi 官方的 OpenAI 兼容 SDK。正确的流程是：

  1. 先通过 files.create 接口上传文档，获取 file_id。
  2. 再通过 files.content 接口获取文档的文本内容。
  3. 最后，将获取到的文本内容，以 role: "system" 或 role: "user" 的身份，作为普通的 text 类型消息，放入 messages 数组中去请求模型。

💎 总结

简单来说，这个错误是因为 Kimi 的 Anthropic 兼容接口不支持 document 类型。最直接的解决方法是换用 Kimi 的专用编码接口 api.kimi.com/coding/，或者改用官方 SDK 的标准文件上传流程来处理文档。