← Volver a las guías

实战调用 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 消息中，可减少提示词混乱并提高输出稳定性。

Precios · Docs