兼容 API 接入

Anthropic 兼容 API:使用 Claude Messages 请求格式

如果现有服务按照 Anthropic Messages API 组织 system、messages 与 max_tokens,可以直接请求无限星河AI的兼容端点。模型 ID 仍从当前公开目录选择,不把厂商展示名或历史型号当作调用名。

Messages 端点为 POST /v1/messages。请求需要 Authorization: Bearer YOUR_API_KEY、Content-Type: application/json,并携带 anthropic-version: 2023-06-01。max_tokens 是必填项且必须大于等于 1。

Messages API 接入要点

POST /v1/messages

Anthropic Messages 兼容请求入口

anthropic-version: 2023-06-01

当前公开文档要求的协议版本请求头

Authorization: Bearer YOUR_API_KEY

Infistar API Key 鉴权方式

model

从模型与价格页面复制的 Claude 模型 ID

max_tokens

必填的最大生成长度,数值至少为 1

从 Anthropic 客户端迁移

  1. 确认客户端允许自定义完整 API 地址或根地址;不能自定义地址的客户端无法只靠替换 API Key 接入。
  2. 保留 Anthropic Messages 的角色与内容结构,并补齐 anthropic-version 请求头。
  3. 把模型改为当前目录中明确支持 Claude / Anthropic 端点的真实调用 ID。
  4. 分别测试普通返回、流式返回、system 提示和工具调用;具体能力取决于所选模型。

Messages API 最小请求

示例只验证协议形状。MODEL_ID 必须替换为当前账户可见且支持 Messages API 的模型。

curl https://coneverse.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

不能从“兼容”推导的内容

  • Messages 格式兼容不表示所有 Claude Beta 请求头、实验字段或厂商特定功能都自动可用。
  • 模型的上下文、思考、工具、多模态与流式能力以当前模型事实和端点标记为准。
  • 出现 401 时先检查 API Key;出现模型不可用时重新读取 GET /v1/models 和模型与价格页面。