完成标准
- 机器人能用一个 OpenAI 兼容的聊天模型给出真实回复。
- API Key 只存在 Wrangler Secret 中,没有出现在代码或仓库里。
什么是 OpenAI 兼容端点
很多模型服务都提供“OpenAI 兼容”接口:只要换掉 base URL 和 API Key,模型名换成对方支持的名字,其余调用方式和 OpenAI 官方 SDK 一样。这样代码几乎不用改就能切换服务商。
一个端点需要三样东西:
- base URL:请求发到哪里。
- 模型名:用哪个模型。
- API Key:你的密钥。
示例:aihubmix(高性价比聊天模型)
aihubmix 是一个 OpenAI 兼容的模型聚合服务,适合课堂用来演示。
- base URL:
https://aihubmix.com/v1(如不通可尝试https://api.aihubmix.com/v1) - 模型名:
gpt-4o-mini(GPT 系列里便宜、速度快的小模型,做客服聊天机器人足够) - API Key:在 aihubmix 后台注册、充值后自行创建
你也可以换成任何其他 OpenAI 兼容服务与模型,只要改这三个值即可。价格、模型可用性以服务商最新文档为准。
把 Key 交给 Worker(Wrangler Secret)
不要把 Key 写进代码或提交到仓库。用 Wrangler Secret 注入,让它只存在 Cloudflare 那边:
npx wrangler secret put OPENAI_API_KEY
运行后按提示粘贴你的 API Key。base URL 和模型名可以放在普通配置(非机密)里,Key 只走 Secret。
常见问题
机器人返回 401 或鉴权失败
Key 没配对或没生效:确认 wrangler secret put 用的名字和代码里读取的变量名一致,Key 没有多余空格,账户已充值。
base URL 请求不通
换用 https://api.aihubmix.com/v1 再试;确认结尾是 /v1,代码里不要重复拼接 /chat/completions。