nexusflow
Claude Messages API

Claude API 接入

Claude 系列通过 HiModels 的原生 Anthropic Messages 兼容上游接入，而不是由 NexusFlow 直连 Anthropic 官方 API。 客户端始终提交稳定公共模型 ID；NexusFlow 将其映射到下表所列的 HiModels AWS 上游 ID。同步 /v1/messages 与 SSE 流式响应均已验证。

✓ 协议支持范围
下列五个 Claude 公共 ID 均使用 HiModels AWS 原生 Anthropic Messages 兼容路径；非流式响应与 Anthropic SSE 事件流均已验证。 JSON 请求体兼容固定 Content-Length、HTTP/1.1 chunked，以及不携带 Content-Length 的 HTTP/2 客户端。

接口地址

POSThttps://nexusflow.hk/v1/messages同步 / 流式

请求参数

参数必选说明
model是稳定公共模型 ID，例如 claude-sonnet-5、claude-opus-5
messages是Anthropic Messages 格式消息数组
max_tokens是最大输出 token 数，不得超过该模型上限
stream否设为 true 时返回 Anthropic SSE 事件流
system否系统提示词，使用 Anthropic 顶层 system 字段
tools否是否支持及具体行为取决于所选模型和 HiModels 上游能力；使用前请核对当前模型说明

支持模型与官方价格

公共模型 IDHiModels 上游快照 ID上下文最大输出USD / MTok 输入/输出
claude-sonnet-5claude-sonnet-5-aws1M128K$2 / $10
claude-opus-5claude-opus-5-aws1M128K$5 / $25
claude-opus-4-8claude-opus-4-8-aws1M128K$5 / $25
claude-sonnet-4-6claude-sonnet-4-6-aws1M64K$3 / $15
claude-haiku-4-5claude-haiku-4-5-aws200K64K$1 / $5

调用示例

curl
curl https://nexusflow.hk/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "用三句话解释什么是模型网关"}
    ]
  }'
curl
curl https://nexusflow.hk/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      {"role": "user", "content": "写一段产品发布文案"}
    ]
  }'

Usage 与可选能力

已验证的同步和流式响应会返回 Anthropic Messages 格式的 usage。上游响应可能包含 cache_creation_input_tokens 与 cache_read_input_tokens 等缓存统计字段。

缓存统计字段存在不代表五个模型都接受 cache_control，工具定义也不是全系列统一承诺。 请按当前模型与 HiModels 渠道说明启用可选能力；NexusFlow 不把未验证能力作为所有 Claude 模型的通用保证。
相关文档