API / curl 接入指南

1. 适用版本与验证日期

最近一次于 2026-10-26 实测。

2. 前置条件

需要账号、API key 和正余额。没有余额时请求返回 HTTP 402（insufficient_quota）。

3. 配置

macOSLinuxWindows

curl https://api.tokenwave.dev/v1/models -H "Authorization: Bearer sk-atr-YOUR_KEY"

curl https://api.tokenwave.dev/v1/messages \
  -H "x-api-key: sk-atr-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":64,"messages":[{"role":"user","content":"Hello"}]}'

curl https://api.tokenwave.dev/v1/models -H "Authorization: Bearer sk-atr-YOUR_KEY"

curl https://api.tokenwave.dev/v1/messages \
  -H "x-api-key: sk-atr-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":64,"messages":[{"role":"user","content":"Hello"}]}'

curl.exe https://api.tokenwave.dev/v1/models -H "Authorization: Bearer sk-atr-YOUR_KEY"

@'
{"model":"claude-sonnet-5-5","max_tokens":64,"messages":[{"role":"user","content":"Hello"}]}
'@ | curl.exe https://api.tokenwave.dev/v1/messages `
  -H "x-api-key: sk-atr-YOUR_KEY" `
  -H "anthropic-version: 2023-06-01" `
  -H "Content-Type: application/json" `
  --data-binary '@-'

4. 选模型

这些模型能用于 API / curl。上面的示例使用你在这里选的模型。

查看能用于 API / curl 的模型

5. 自检

第一条命令列出你的 key 可用的模型；返回 JSON 列表说明 key 和地址都可用。

6. 发第一条提示

发送这句提示：“Reply with the single word ready.”然后打开请求记录页：一分钟内会看到这条请求，含模型、token 数和费用。

打开请求记录

7. 已知限制

按模型提供的接口选择调用方式（见模型页）。经转换的接口不转发提示缓存标记。

8. 排错

症状	原因	修复
401 Unauthorized	key 填错、已吊销，或带了多余空格。	到 API keys 页重新复制完整的 key，并确认它是有效状态。
403 Forbidden	这个 key 不能用该模型，或账户受限。	到 API keys 页检查 key 允许的模型，或换一个 key。
404 Not Found	基础地址不对：/v1 重复或缺失。	原样使用示例里的地址。Claude Code 不带 /v1，其他工具带 /v1。
model not found	模型 ID 写错，或你的 key 不能用它。	从目录复制 ID，或用 GET /v1/models 查看 key 可用的模型。
返回 HTML 页面或 “Attention Required”，不是 JSON	网关前面的网页防火墙拦截了请求体。	重试一次。反复出现时，带上时间和请求 ID 联系支持。
我传的某个参数好像没有生效	网关只转发该接口已知支持的字段，其余字段会被丢弃（不会报错）。	查看响应头 x-atr-ignored-fields：它列出了没有被转发的顶层字段。去掉这些字段，确实需要时联系支持。

9. 还原

无需还原。不再需要时到 API keys 页删除这个 key。