Claude API 中转与 Messages 接口接入指南

选择 Claude 原生协议还是兼容协议

新项目如果依赖 Anthropic SDK 的消息结构、system 指令和内容块，可以使用 Claude Messages 协议。已经基于 OpenAI SDK 开发的应用，则可以先使用兼容接口降低迁移成本。

不同协议对工具调用、图片输入和流式事件的字段定义不同。不要只替换 URL 后假设所有高级字段完全一致，应按目标协议完成一次端到端测试。

Claude Messages 请求要点

请求中应明确模型、最大输出长度与 messages。system 指令通常作为独立字段发送，而不是混入普通用户消息。

curl https://modbapi.com/v1/messages \
  -H "x-api-key: YOUR_MODB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"your-claude-model","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

稳定性与成本控制

为 Claude 调用设置合理的最大输出长度、请求超时和并发限制，避免长文本任务意外占用过多额度。

控制台中的 Token、耗时和扣费记录可用于定位异常请求。批量任务应先使用小样本验证提示词和输出长度。