OpenAI-compatible API guide

Node Express OpenAI Compatible API:后端代理与重试

Node/Express 服务端接入兼容 API 时的 baseURL、timeout、retry 和错误响应处理。

base_urlAPI Key预算上限错误处理

最小验证请求

先用测试 Key 做一次真实请求,再接入正式业务。

curl https://api.clawskills.shop/v1/chat/completions \
  -H "Authorization: Bearer YOUR_CLAWSKILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"控制台选择的模型","messages":[{"role":"user","content":"ping"}],"max_tokens":80}' 

接入前确认

  • base_url 指向控制台提供的兼容接口。
  • API Key 只放服务端环境变量,不进浏览器。
  • 先设置低预算测试 Key,避免脚本循环消耗。

上线前确认

  • 记录 200、429、500/503、timeout。
  • 设置超时、重试、备用模型和降级回复。
  • 观察首 token 延迟、总耗时、单次成本。

转化路径

  • 注册控制台。
  • 价格页确认可用模型。
  • Token 页创建测试 Key。
  • Playground 跑通第一条调用。

常见问题

这是 OpenAI 官方接口吗?

不是官方同源承诺。本页介绍的是 OpenAI 兼容多模型网关接入方式,实际模型、价格和可用性以 ClawSkills 控制台为准。

是否要一次充值很多?

不建议。先用小额测试 Key 验证连通性、延迟和输出质量,再根据真实调用量决定是否充值或订阅。

接入失败先查哪里?

先查 base_url、Key、模型名、账户额度、请求体格式和服务端日志,再看是否需要重试或切换备用模型。

下一步

如果你已经有现成项目,先复制最小请求跑通,然后把模型名、预算和错误重试写进服务端配置。

创建 API Key

合规说明:ClawSkills 定位为开发者 OpenAI-compatible multi-model API gateway,不宣传号池、无限量、官方同源、全网最低价或收益保证。