开发者文档

接口遵循 OpenAI 兼容协议，现有 SDK 只需替换 Base URL 与密钥即可接入。

接口地址

Base URL	`https://api.hbwcny.site/v1`
鉴权方式	`Authorization: Bearer sk-你的密钥`
协议	HTTPS / JSON，支持 `stream: true` 流式输出

对话接口

POST /v1/chat/completions

curl https://api.hbwcny.site/v1/chat/completions \
  -H "Authorization: Bearer $WENCHA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wencha-chat",
    "messages": [
      {"role": "user", "content": "用三句话介绍在线数据处理服务"}
    ],
    "stream": false
  }'

返回结构与 OpenAI 一致：choices[0].message.content 为文本结果，usage 为本次 Token 用量。

模型列表

GET /v1/models 返回当前账号可用的模型清单。具体可用型号以开通时确认的档位为准。

错误码

状态码	含义	处理建议
400	请求参数不合法	检查 JSON 结构与字段类型
401	密钥无效或已停用	核对密钥；如已泄露请立即更换
402	余额不足	充值后重试
404	模型不存在	先用 `/v1/models` 确认型号
429	触发限流	退避重试，或申请提高配额
5xx	服务暂时不可用	指数退避重试；持续失败请联系客服

使用规范

密钥仅限本单位使用，不得转售、分许可或提供给未授权第三方。
不得用于法律法规禁止的用途；使用本服务生成并对外发布的内容，应按国家规定显著标识为 AI 生成。
请勿在请求中提交与服务无关的敏感个人信息；确需处理的，应自行取得合法授权。

联调支持：遇到接入问题请通过页脚客服渠道联系我们，工作日 9:00–18:00 响应。