第 12 章 / 共 21 章约 1 分钟

12. Anthropic Messages 兼容端点#

POST /v1/messages — 在 OpenAI 兼容管线之上额外提供 Anthropic Messages API 协议兼容,可被 官方 Anthropic 客户端 / SDK 驱动,无论底层通道实际是 OpenAI 还是 Anthropic。支持非流式与流式(流式为服务端合成的 Anthropic SSE 事件序列)。

认证注意事项#

该端点与其他端点一致,使用 Authorization: Bearer sk-... 认证,不接受 Anthropic 默认的 x-api-key 头。使用 Anthropic 官方 SDK 时,需将密钥以 Bearer 头方式传入(例如通过 SDK 的 auth_token 参数或自定义请求头),而非默认的 api_key(后者发送 x-api-key)。

能力范围#

  • 支持:纯文本 messages、system 提示、max_tokens、stream 等基础字段。
  • 不支持:tools / tool_choice(函数调用)、非文本内容块(图片等多模态)。遇到这些字段会直接返回 400,错误体为 Anthropic 形状,而非静默丢弃。
  • 所有错误(含鉴权、权限、参数)统一以 Anthropic error 形状返回。
cURL
curl http://183.240.79.21:52099/v1/messages \
  -H "Authorization: Bearer sk-你的YiTuoToken-Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 256,
    "system": "你是一个简洁的助手。",
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

如需函数调用 / 多模态等高级能力,请改用 /v1/chat/completions(OpenAI 格式)。