Claude-compatible API

目标

使用 Claude-compatible Messages 协议发出最小请求，并确认当前模型、渠道和日志都支持该路径。

前置条件

已创建低额度、短有效期、单模型 Key。
当前模型同时出现在 /v1/models、模型广场和支持 Claude-compatible 的可用渠道中。
Key 存入 INFINITEX_API_KEY，模型 ID 存入 INFINITEX_MODEL。

准确入口

Endpoint：https://api.infinitex.pro/v1/messages

操作步骤

用当前 Key 请求 /v1/models，选择支持 Messages 的模型。
发送最小请求：

curl --fail-with-body --silent --show-error \
  https://api.infinitex.pro/v1/messages \
  -H "x-api-key: $INFINITEX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  --data '{"model":"'"$INFINITEX_MODEL"'","max_tokens":16,"messages":[{"role":"user","content":"Reply with exactly: InfiniteX OK"}]}'

核对 HTTP 状态和最小文本结果，不把完整响应保存到公开材料。
在使用日志确认 /v1/messages、模型、Token、费用、耗时和 request ID。
永久删除临时 Key，再确认认证失败。

成功结果

Messages 请求返回 HTTP 2xx 和文本内容；InfiniteX 使用日志出现同一时刻记录；删除 Key 后不能继续访问 API。

常见错误

状态/现象	可执行检查
`400`	`max_tokens`、`messages` 和 `anthropic-version` 是否完整
`401`	`x-api-key` 是否使用当前有效 Key
`404`	Base URL 是否误写为文档域名或重复追加 `/v1/messages`
协议不支持	当前模型与渠道是否实际支持 Claude-compatible Messages
日志无记录	请求可能在到达服务前失败；检查客户端 Base URL 和网络

安全与计费影响

Header 中的 Key 是完整凭据，不得进入命令历史、截图或支持材料。客户端自动重试可能产生多次费用；先用 max_tokens 小值验证。

下一步

配置Claude Code，或阅读常见错误与排查。

目录