← Back to all guides

5分钟完成首个 Claude API 调用：59API 新手实战指南

准备：你需要什么

第一次调用 Claude API 不需要搭建复杂项目，只需要一个 59API 账号、已充值或可用的账户余额，以及终端工具。59API 提供 Claude Opus、Sonnet、Haiku、Fable 和 GPT 等模型的按量付费访问，适合先验证功能、再逐步扩展的个人开发者和小团队。它使用官方质量的原生模型，不需要为了降低成本接受模型降级，同时接口可兼容 Claude Code、Codex 和常见 OpenAI SDK。

先在 59API 控制台注册并创建 API Key。API Key 相当于账户密码，不要提交到 Git 仓库、截图公开或直接写进前端网页。建议把它保存为本机环境变量：在 macOS 或 Linux 终端执行 export ANTHROPIC_API_KEY='你的59API密钥'。Windows PowerShell 可使用 $env:ANTHROPIC_API_KEY='你的59API密钥'。这样后续命令和程序都不必反复粘贴密钥。

发送第一条 Messages 请求

Claude 的常用接口是 Messages API。请求地址使用 59API 基础地址加上路径：https://api.59api.com/v1/messages。请求方法为 POST，并带上 JSON 内容、API Key 和 Anthropic 版本头。模型名称请以 59API 控制台当前展示的可用名称为准；初次测试可优先选价格更低、速度更快的 Haiku，确认业务效果后再尝试 Sonnet 或 Opus。

在终端中执行以下请求，其中 YOUR_MODEL 替换为控制台中的模型 ID：curl https://api.59api.com/v1/messages -H "content-type: application/json" -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -d '{"model":"YOUR_MODEL","max_tokens":200,"messages":[{"role":"user","content":"请用一句话解释什么是 API。"}]}'

成功后会返回 JSON。你通常会看到 id、model、usage 和 content 等字段，真正的回答位于 content 数组中第一个 text 项。usage 会包含输入与输出 token 用量，是估算成本、定位异常消耗的重要依据。第一次测试建议把 max_tokens 设为 100 到 300，既足够看到结果，也能避免生成过长内容。

把请求接入你的代码

如果项目已经使用 Anthropic SDK，核心配置通常只需将 API Key 换成 59API 的密钥，并把 SDK 的 base URL 指向 https://api.59api.com。调用参数仍然保持 model、max_tokens、messages 这些标准字段。使用 OpenAI SDK 的项目也可根据 59API 文档选择兼容入口和模型名称，因此迁移时应先在独立测试脚本中验证一条简单请求，再接入聊天、摘要或代码生成等正式功能。

不要把 API Key 放在浏览器 JavaScript 中。正确做法是让网页把用户输入提交给自己的后端，由后端调用 59API，再把经过必要处理的结果返回前端。这样可以避免密钥被查看页面源码的用户获取，也方便实施登录、额度、敏感词和请求频率控制。

常见报错排查

• 401 或 403：检查 API Key 是否完整、环境变量是否已在当前终端生效，以及账户状态和余额。
• 404：确认地址为 https://api.59api.com/v1/messages，避免漏掉 /v1/messages 路径。
• 模型不可用：不要猜测模型 ID，直接复制 59API 控制台或文档提供的名称。
• 400 请求错误：检查 messages 是否为数组、role 是否为 user，以及 JSON 引号和逗号是否正确。
• 回答被截断：适当提高 max_tokens；若追求更低成本，可先缩短提示词和上下文。

完成这一步后，你已经拥有可复用的 Claude 调用基础。下一步可以为请求加入 system 指令、历史 messages、多轮对话和流式输出。对于希望以较低成本持续试用多种 Claude 与 GPT 模型的开发者，可以注册 59API，按实际 token 用量付费，并了解其推荐返利机制。

Pricing · Docs