捷特森 AI基础地址与身份验证
API 根地址：https://www.gwgear.cn/v1
在请求头中加入：Authorization: Bearer 您的API_KEY
不要把 API Key 写进公开网页、Git 仓库或客户端安装包。推荐从服务器环境变量读取。
获取可用模型
curl https://www.gwgear.cn/v1/models \
-H "Authorization: Bearer $GWGEAR_API_KEY"
公开价格请查看模型广场。不同 Key 可能具有不同的模型白名单。
聊天接口
POST /v1/chat/completions
curl https://www.gwgear.cn/v1/chat/completions \
-H "Authorization: Bearer $GWGEAR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"模型ID","messages":[{"role":"user","content":"你好"}]}'
当前暂不支持流式输出。请求中的 stream 会被安全地设置为 false。
计费说明
费用按输入、输出、缓存读取和缓存写入 Token 分别计算；阶梯模型还会按输入或输出 Token 区间选择费率，最后向上取整到人民币分。当前聊天接口仅开放已覆盖计费的能力；不接受带独立费用的上游内置工具，Gemini 暂只开放文本输入，Qwen Plus 暂只开放非思考模式。响应头包含：
x-request-id: 本次请求编号
x-gwgear-charge-cents: 本次实际扣费（分）
x-gwgear-balance-cents: 扣费后余额（分）
常见错误
| 状态码 | 含义 |
|---|---|
| 400 | 参数错误或缺少 model |
| 401 | API Key 无效、停用或过期 |
| 402 | 余额不足 |
| 403 | 模型无权限或达到月度限额 |
| 404 | 模型未开放 |
| 429 | 超过每分钟请求限制 |
| 502/504 | 上游错误或超时，可使用请求编号联系支持 |
安全建议
为每个项目使用独立 Key；发现泄露时立即在客户控制台重置；生产环境设置月度上限和模型白名单；日志中只记录 Key 前缀，不记录完整 Key。