← 所有文章

Claude API：密钥、/v1/messages 端点与模型版本选择

深色背景上发光的数字访问密钥，旁边漂浮着立体的文字方块

Claude API 让你从自己的代码里调用 Claude 模型，而不是在聊天窗口里对话：网站上的客服机器人、自动分派工单的脚本、编辑器里的代码补全、CRM 集成，都是典型场景。在 NeuralSpace 上，一分钟内就能在个人中心创建密钥，请求发往兼容 Anthropic 的 POST /v1/messages 端点，用账户余额的 token 付款——无需订阅。下面按步骤说明：如何拿到密钥、第一次调用长什么样，以及如何选择模型版本——Haiku、Sonnet、Opus 还是 Fable。

Claude API 是什么，和聊天有何不同

Claude 是 Anthropic 的语言模型家族。在聊天窗口里，你手动和模型对话；通过 API，你的代码做同样的事：发送一组消息，拿到生成的回复，再放进自己的产品里——展示给用户、存入数据库、做后续处理。典型用途：客服机器人、邮件和文档摘要、从文本抽取结构化数据、起草内容、在脚本里自动化重复劳动。与聊天最大的区别是可控性：系统指令、回复上限和模型版本都由你设定，消耗以 token 计量。

第 1 步：获取密钥

  1. 用邮箱在 NeuralSpace 注册——不到一分钟。新用户会获得初始 token，足够完成最初的几次调用，无需充值。
  2. 在个人中心打开 「API 密钥」页面，填写密钥名称（例如「我的机器人」），点击「创建」。
  3. 密钥形如 nsk-… 且只显示一次——请立即复制到密码管理器或环境变量，不要提交进代码仓库。
  4. 检查余额：文本模型要求账户至少有 50 个 token。充值在个人中心完成，没有订阅费。
NeuralSpace 的 API 密钥页面：创建密钥与 Claude 快速开始

第 2 步：第一次调用 /v1/messages

Claude 文本模型位于兼容 Anthropic 的 POST https://neuralspace.pro/v1/messages 端点。请求体包含模型、带 user/assistant 角色的 messages 数组、回复上限 max_tokens（1 到 32000）以及可选的系统指令 system。最小 curl 请求：

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-你的密钥" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "你用简短的话回答技术问题。",
    "messages": [{"role": "user", "content": "流式输出和普通回复有什么区别？"}]
  }'

响应采用 Anthropic 格式：文本在 content[0].text，实际消耗在 usage 字段。身份验证用 x-api-key: nsk-… 请求头；只支持 Bearer 的客户端也可以用 Authorization: Bearer nsk-…。

第 3 步：接入 Anthropic SDK

如果你已有基于官方 Anthropic SDK 的代码，只需改两个值——base_url 和密钥：

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-你的密钥",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="你用简短的话回答技术问题。",
    messages=[{"role": "user", "content": "给一个关于 AI 的频道想三个名字"}],
)
print(resp.content[0].text)

做聊天界面时流式输出很有用：加上 "stream": true，回复会通过 Server-Sent Events 分块返回，用户在生成结束前就能看到开头几个字。

选哪个模型版本

NeuralSpace 公开目录里有四个 Claude 版本，区别在于「速度与价格」和「推理深度」之间的取舍。以下价格以站点 token 计，每百万 API token，输入和输出分开计费（写作时的数据，费率会浮动）：

  • Claude Haiku 4.5（claude-haiku-4-5）——41 / 213。最快最便宜：分类、短回答、批量文本处理、初步标注。
  • Claude Sonnet 5（claude-sonnet-5）——152.5 / 767。主力型号：写代码、长指令、带上下文的对话。合理的默认选择。
  • Claude Opus 5（claude-opus-5）——359 / 1794.5。用于难题：多步推理、大文档分析、精细逻辑。
  • Claude Fable 5（claude-fable-5）——718 / 3589.5。面向最苛刻场景的旗舰，质量比价格更重要时选它。

实用规则：从 Haiku 或 Sonnet 开始，只在它们确实不够用时，才针对性地切到 Opus 和 Fable。版本由请求里的一个 model 字段决定，所以可以在同一个提示词上对比它们。

流式输出、限制与服务端点

新手常撞上两个限制：每个密钥每分钟 60 次请求，以及文本模型最低 50 个 token 的余额门槛。当前余额由 GET /v1/balance 返回，带实时价格的机器可读模型列表由 GET /v1/models 返回。两者都需要密钥。最新费率始终显示在 API 文档页面的表格里。

Claude API 与 MCP：接入 Claude Code

用同一个密钥，NeuralSpace 可以作为 MCP 服务器接入 AI 智能体：智能体自己就能以你的账户名义调用聊天、图片、视频和音乐生成。对 Claude Code 来说只需一条命令：

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-你的密钥"

如果暂时不需要 API，同样的模型在界面里也能用——在聊天里选 Claude 就能不写代码直接对话，余额在聊天和 API 之间通用。

常见问题

需要 Anthropic 账号或外币卡吗？

不需要。密钥在 NeuralSpace 个人中心签发，用账户 token 付款——没有订阅，也不用配置云计费。

/v1/messages 和 /v1/chat/completions 有什么区别？

它们是同一个 API 的两种格式。/v1/messages 对应 Anthropic Messages API（字段 model、messages、system、max_tokens），适合 Claude 模型和 Anthropic SDK；/v1/chat/completions 是 OpenAI 格式，用于 GPT 和 Grok 聊天模型。变的只是地址和请求体结构。

调用 Claude API 要花多少钱？

只为实际消耗的 token 付费：写作时 Claude Sonnet 5 为每百万输入 152.5 token、每百万输出 767 token。几千 token 的请求大约 1 ₽。最新价格见 GET /v1/models 和文档表格。

有免费套餐吗？

平台上没有免费生成。新用户会获得初始 token，够做最初的几次尝试；之后按 token 计费，没有订阅费。