Claude API 概览 — 端点、格式与限制
ClaudeStore Claude API 完整端点列表、请求/响应格式、流式输出与速率限制说明。
基础 URL
https://api3.claudestore.storeOpenAI 兼容接口前缀：/v1
主要端点
- POST /v1/messages — Anthropic Messages API
- POST /v1/chat/completions — OpenAI 兼容
- GET /v1/models — 模型列表
- GET /healthz — 网关健康检查
流式输出（SSE）
在请求体添加 "stream": true 即可启用流式输出。响应通过 text/event-stream 推送增量内容。
速率限制
速率限制按套餐生效：Starter — 60 RPM，Pro — 300 RPM，Business — 1000 RPM，Team — 2000 RPM。超出限额返回 429，并附带 retry-after 头。
冒烟测试 gateway
验证 gateway 访问
在发送真实请求之前，先做两个低成本检查：健康探测和模型列表。它们能确认 base URL、网络以及（对于 /v1/models）你的 API key — 完全不消耗额度。
1. 存活探测 — /healthz
公开端点，无需鉴权。gateway 在线时返回 200 和 JSON 状态。可在 CI、监控或任何 shell 中使用。
curl -sS -o /dev/null -w "HTTP %{http_code}\n" \
https://api3.claudestore.store/healthz2. 鉴权 + 模型目录 — /v1/models
返回 /v1/messages 可用的模型 ID 列表。需要有效的 x-api-key。如果通过，说明 key、base URL 和请求头都正确。
curl -sS https://api3.claudestore.store/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | jq '.data[].id'正常响应应该是什么样
- /healthz → HTTP 200，响应体 {"status":"ok", ...}。其他情况（超时、5xx、HTML 页面）意味着访问了错误的主机或存在网络/代理问题。
- /v1/models → HTTP 200，响应体 {"object":"list","data":[...]}。data 中列出的就是 /v1/messages 接受的全部模型 ID。
常见错误
- 错误的 base URL。唯一正确的主机是 https://api3.claudestore.store。不要使用 api.anthropic.com、api.claudestore.store（旧）或其他变体。
- 缺少 /v1 前缀。所有业务端点都在 /v1/* 下（如 /v1/messages、/v1/models）。/healthz 是唯一例外，位于根路径。
- 错误的鉴权头。请使用 x-api-key: sk-cs2-...（Anthropic 风格）。除非 SDK 自动处理，否则不要发送 Authorization: Bearer ...。
- 无效的模型 ID。只有 /v1/models 返回的 ID 才能工作。当前为：claude-sonnet-4.6、claude-haiku-4.5、claude-opus-4.7。
提示：在脚本和 CI 中以 /v1/models 作为模型 ID 的唯一来源 — 不要硬编码列表。