← 返回“接入 OpenAI 兼容聊天模型”
课前操作攻略

配置 OpenAI 兼容模型端点(aihubmix 示例)

用一个 OpenAI 兼容端点给聊天机器人接入大模型,API Key 用 Wrangler Secret 注入。

完成标准

  • 机器人能用一个 OpenAI 兼容的聊天模型给出真实回复。
  • API Key 只存在 Wrangler Secret 中,没有出现在代码或仓库里。

什么是 OpenAI 兼容端点

很多模型服务都提供“OpenAI 兼容”接口:只要换掉 base URL 和 API Key,模型名换成对方支持的名字,其余调用方式和 OpenAI 官方 SDK 一样。这样代码几乎不用改就能切换服务商。

一个端点需要三样东西:

  • base URL:请求发到哪里。
  • 模型名:用哪个模型。
  • API Key:你的密钥。

示例:aihubmix(高性价比聊天模型)

aihubmix 是一个 OpenAI 兼容的模型聚合服务,适合课堂用来演示。

  • base URLhttps://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

完成后返回课前准备 →