实战调用 Claude Messages API：用 59API 接入 Sonnet 与 Opus
为什么用 Messages API 调用 Claude
Claude Messages API 是 Anthropic 模型的核心对话接口，适合客服机器人、代码审查、文档总结、结构化问答和 Agent 工作流。一次请求由模型名、最大输出长度、可选系统提示词及 messages 数组组成。对于需要控制成本的开发者，59API 提供 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型的按量付费中转服务，接口兼容 Claude Code、Codex 和常见 SDK，且使用原生官方质量模型，无需为了价格牺牲输出效果。
准备密钥与请求地址
先在 59API 控制台创建 API Key，然后将请求基础地址设为 https://api.59api.com。Claude Messages API 的完整地址通常为 https://api.59api.com/v1/messages。请求使用 POST，并携带 x-api-key、anthropic-version 与 content-type 三个请求头。不要把密钥直接写进前端代码或提交到 Git 仓库，应放入环境变量，例如：export API_KEY="你的_59API_Key"。
用 curl 发送第一条消息
下面的请求选择 Claude Sonnet，并要求模型用中文解释递归。model 可按账户可用模型替换为对应的 Claude 型号；max_tokens 用于限制回复长度，也是控制预算的重要参数。
curl https://api.59api.com/v1/messages -X POST -H "x-api-key: $API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"claude-sonnet-4-5","max_tokens":500,"system":"你是一名耐心的中文编程助教。","messages":[{"role":"user","content":"用一个 JavaScript 例子解释递归。"}]}'
成功响应中的 content 通常是内容块数组，读取第一个 text 类型内容即可获得答案。响应还会包含 usage 信息，其中 input_tokens 和 output_tokens 可用于记录消耗、分析提示词长度并设置告警。生产环境应保存请求时间、模型、状态码和 token 用量，但不要记录用户敏感原文或 API Key。
Node.js 调用与错误处理
在 Node.js 18 及以上版本中可直接使用 fetch。以下示例检查 HTTP 状态，避免接口失败时仍把错误 JSON 当作模型回答处理。
const response = await fetch("https://api.59api.com/v1/messages", { method: "POST", headers: { "x-api-key": process.env.API_KEY, "anthropic-version": "2023-06-01", "content-type": "application/json" }, body: JSON.stringify({ model: "claude-sonnet-4-5", max_tokens: 500, messages: [{ role: "user", content: "为这个函数补充单元测试思路。" }] }) }); if (!response.ok) throw new Error(`API 请求失败：${response.status}`); const data = await response.json(); console.log(data.content[0].text);
模型选择与成本控制
- Haiku：适合分类、提取、短文本改写等高并发任务，优先追求速度与单次成本。
- Sonnet：适合日常编码、分析和多数生产对话，是质量与价格之间常用的平衡选择。
- Opus：适合复杂推理、长上下文分析和高难度代码任务，应为高价值请求保留。
- Fable：适合需要对应模型能力或兼容既有工作流的场景，实际选择应以业务评测结果为准。
控制费用的关键不是一味选择最便宜模型，而是先缩短无关上下文、为不同任务路由模型、合理设置 max_tokens，并在应用层限制重试次数。59API 的低价按量付费方式适合从小流量验证开始，后续按实际调用扩展；其推荐返利机制也能进一步降低长期使用成本。注册 59API 后，可先用一组真实业务样本比较 Sonnet、Haiku 与 Opus 的质量、延迟和 token 消耗，再确定默认模型。
常见排查项
收到 401 时先确认 x-api-key 是否正确、环境变量是否已加载；收到 400 时检查 model、max_tokens 和 messages JSON 结构；收到 429 时应使用指数退避重试，并避免并发瞬间放大。若要实现多轮对话，把此前 user 与 assistant 消息按顺序继续放入 messages 数组。系统规则放在 system 字段，业务输入放在 user 消息中，可减少提示词混乱并提高输出稳定性。
शुरू करने के लिए तैयार?
कुछ ही मिनटों में Claude और GPT जोड़ें, सबसे कम कीमत पर। साइन अप करें और API key पाएं।
मुफ़्त साइन अप