Anthropic Messages

POST /v1/messages —— Anthropic Messages API 兼容接口,支持同步与流式。Anthropic SDK 改 base_url 即可。

鉴权与请求头

Anthropic SDK 默认通过 x-api-key 头发送 key,并自动附带 anthropic-version。请保留 anthropic-version(如 2023-06-01),它会被透传到上游用于协议行为选择;anthropic-beta(如 prompt-caching-2024-07-31)同理。

请求字段

强校验字段:model(= model_code,非空)、messages(非空)。其余字段(max_tokens、system、tools、tool_choice、thinking、temperature、top_p、top_k、stop_sequences 等)原样透传。

示例

Python

from anthropic import Anthropic

client = Anthropic(
    base_url="https://xingsuan.cloud",
    api_key="xsk_...",
)

msg = client.messages.create(
    model="claude-3-5-sonnet-latest",
    max_tokens=256,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)

curl

curl https://xingsuan.cloud/v1/messages \
  -H "x-api-key: $XSK_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-latest",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

流式设置 stream: true,响应为 Anthropic 标准事件流(message_start、content_block_delta、message_stop 等),由网关原样透传。

Token 计数

POST /v1/messages/count_tokens —— 预估输入 token 数,不计费、不落库。请求体只需 model + messages(无 stream / max_tokens),返回:

{ "input_tokens": 42 }

错误

错误信封为 Anthropic 形状({"type":"error","error":{"type","message"}}),error.type 按状态映射,详见 错误码。