RUN7 / 知识与工具
Claude API 编程接入:Messages、兼容接口与缓存
用 Claude API 编程,先确认工具需要原生 Messages 还是 OpenAI 兼容接口。模型名称能填进去还不够,工具调用格式、流式事件和上下文限制也需要实际验证。
API 与聊天订阅分开理解
聊天产品的订阅不能直接视为第三方 API 额度。API 使用独立 Key、权限和计费安排。Run7 通过人工确认订单与续费,交付时提供当前 Key 可用的模型清单。
小范围代码修改可以先测试成本较低的选项;跨文件重构则应在自己的代码上对比完成质量和总任务成本。不能只凭模型名就承诺所有编程任务效果。
核对编程工具要求的协议
原生 Messages 使用 model、messages 和明确的输出上限,并携带 x-api-key 与 anthropic-version。Chat Completions 兼容方式的响应结构不同。不要在原生 Messages 字段中填入 Chat Completions 的完整路径。
POST /v1/messages
x-api-key: YOUR_TEST_KEY
anthropic-version: 2023-06-01
Content-Type: application/json
{"model":"YOUR_MODEL_ID","max_tokens":32,
"messages":[{"role":"user","content":"Reply OK"}]}若服务要求其他 API 版本,应使用交付说明给出的版本。短文本调用成功,不代表 Claude Code 的所有功能都兼容。
开启 Agent 前逐项验证
- 先验证短文本,再验证流式输出。
- 使用无副作用的小工具测试,检查客户端是否完成工具结果回传。
- 设置输出和费用上限,长历史与重复文件会增加输入用量。
- 按具体接口确认图片、缓存、上下文能力,不要只看系列名称。
怎样控制实际任务费用
接口支持缓存时,稳定指令尽量保持一致;是否命中取决于模型规则和请求结构,写入也可能计费。成本比较要同时看任务完成质量与总用量,单价低不一定代表完成一个任务更便宜。
继续阅读 缓存与 Token 计费,或进行 API 基础检测。
联系获取 Key ↗