给网页装上 AI 大脑

从「API 到底是什么」开始,到最后亲手把密钥填进代码,
让一个网页真的能跟大模型聊天。

slides无需编程基础
const BASE = "https://…/v1";
const KEY = "sk-你的密钥";
const MODEL = "模型名";
// 改这三行,网页就会说话了
按 → 或 空格 翻页 · 按 M 看目录
ROADMAP · 今天要走的路

四站,从听懂到做出

STOP 01

搞懂 API

网页是怎么「打电话」给 AI 的?用点 restaurant 来理解。

STOP 02

认识密钥

它就像门禁卡,也像你的账号密码,丢了会怎样?

STOP 03

让 AI 写代码

一句提示词,生成一个能直接运行的单文件网页。

STOP 04

填进去跑起来

在在线编辑器里粘贴代码、插入 API 与密钥,开始对话。

学习目标:你能独立做到「看到一段 AI 生成的 HTML,知道该改哪几行、怎么填、出错了怎么查」。
STOP 01 · 什么是 API

把 AI 想成一家餐厅

API 就是「点菜的规则」:你不用进厨房,只要按菜单说清楚要什么,服务员就会把菜端回来。

你的网页顾客:提出需求
→
API 接口服务员:传递请求
→
AI 大模型厨房:生成回答
→
返回结果上菜:网页显示答案

菜单 = 接口文档

告诉你能点什么、怎么点,比如 /chat/completions 表示「我要一次聊天补全」。

点单 = 请求

把「模型名」和「你说的话」打包成一段 JSON 发过去。

账单 = 用量

每次请求都会记用量,所以密钥不能随便给别人。

STOP 01 · 一次请求里有什么

三个东西,缺一不可

① 地址

BASE URL

去哪里找 AI。每个服务商的地址不同,最后拼上接口路径。

② 凭证

API KEY

证明「我是我」。放在请求头里,服务端靠它认出你的账号。

③ 内容

BODY

用哪个模型、你想问什么、要不要流式输出。

fetch(BASE + '/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer ' + KEY }, // ② 亮出门禁卡 body: JSON.stringify({ model: MODEL, // ③ 选哪个「厨师」 messages: [{ role: 'user', content: '你好' }] }) })
这三行在几乎每个 AI 网页里都长差不多——看懂了它们,你就能看懂大部分 AI 生成的代码。
STOP 02 · 密钥安全

密钥 = 你的门禁卡

谁拿到这串字符,谁就能用你的额度调用接口。所以它比「用户名」重要得多。

可以做的

在本地练习、填进自己的 HTML、用完后保存在自己的笔记里。

特别提醒:在线代码预览工具虽然把代码存在浏览器本地,但一旦点「复制分享链接」,含密钥的整段代码会被发送到短链接服务。
STOP 02 · 模型与真实情况

模型很多,但不是每个都能用

不同模型像不同厨师:有的快、有的聪明、有的支持看图。我们实测过一批接口,结果如下:

服务商实测结果典型提示
智谱 BigModel1 个可用其余返回「余额不足或无可用资源包」
OpenRouter密钥无效新旧密钥均返回 401 User not found
NVIDIA NIM3 个可用换新密钥后 200 OK;z-ai/glm-5.3-flash 响应超时
200

成功

401

身份不对,先查 Key

403

没权限 / Key 失效

429

额度不足或请求太快

看到报错别慌:先读状态码,再读 error.message,错误信息通常已经告诉你该怎么改。
STOP 03 · 让 AI 帮你写网页

先学会「下需求」

把下面这段发给任意 AI,它就会生成一份能直接粘贴运行的单文件 HTML:

请生成一个单文件 HTML 页面,HTML/CSS/JS 全部写在同一个文件里, 可以直接粘贴到在线编辑器运行。要求: 1. 顶部定义三个常量 BASE_URL、API_KEY、MODEL,方便我填写; 2. 使用 OpenAI 兼容的 /chat/completions 接口; 3. 支持流式输出,并显示请求失败的原始错误信息; 4. API_KEY 写成占位符,不要写死任何真实密钥; 5. 页面上要有输入框、发送按钮和对话区域。
好提示词的关键:说清格式、说清要留空的地方、说清报错怎么显示。
STOP 04 · 在线编辑器

把代码粘进去,立刻能看效果

网址:tools.omikuji.dev/zh-cn/code-preview/ 无需注册,代码只存在你自己的浏览器里。

HTML 在线运行 · 实时预览
HTMLCSSJS自动刷新 ✓ 运行
<button id="send">发送</button> <div id="chat"></div> <script> const KEY = "sk-你的密钥"; ... </script>
预览区

你:你好

AI:你好!有什么可以帮你?

停止输入 0.4 秒后自动刷新预览
✓ 控制台:console.log 和报错都会显示在这里,查错看这一栏
只用「下载 HTML」保存文件。不要点「复制分享链接」——它会把代码(含你填的密钥)发到短链接服务。
STOP 04 · 关键一步

把 API 和密钥插进代码

AI 生成的代码里,这三行通常是占位符。你只需要改它们,其他一行都不用动。

修改前 · 占位符
const BASE_URL = "https://xxx/v1"; const API_KEY = "sk-你的密钥"; const MODEL = "模型名";
修改后 · 填真实信息
const BASE_URL = "https://open.bigmodel.cn/api/paas/v4"; const API_KEY = "你自己的密钥"; const MODEL = "GLM-4-Flash-250414";
注意引号要保留、不要写中文引号、密钥前后不要多空格。改完等 0.4 秒预览会自动刷新,或点「运行」。
资源清单 · 从文档导入

三组接口信息,点一下就复制

下面是从你的文档原样导入的地址、密钥和模型名单。每块内容都可以点一下直接复制,也可以直接粘贴到下一页的练习里。

智谱 BigModel

1 个可用

OpenRouter

密钥无效 401

NVIDIA NIM

3 个可用
现在轮到你

填一填,生成你的网页代码

这里只是演练环境,填写的密钥只留在你当前浏览器页面里。
实时生成的配置改输入即更新
完整 HTML 代码点「生成完整 HTML」后复制整段,粘贴到编辑器 HTML 标签
排错手册 · 出问题时看这里

常见报错速查表

401 / User not found

密钥不存在或填错。检查是否漏了 Bearer 前缀、是否复制完整、末尾有没有空格。

403 / Authorization failed

密钥无效、过期,或这个账号没开通该模型的权限。换一个可用模型试试。

429 / 余额不足或限流

账户没钱了、资源包过期,或短时间请求太多。等一会儿,或换免费模型。

404 / 地址或模型不存在

BASE URL 拼错、模型名写错,或者服务商根本没有这个模型。

浏览器里 CORS 报错

有些服务商不允许网页直接请求。换一个支持浏览器调用的服务商,或改用本地后端转发。

返回了空内容

可能是 max_tokens 太小(比如设成 1),回答被截断了。调大后再试。

排错顺序:地址 → 密钥 → 模型名 → 参数 → 浏览器限制,一次只改一个地方,改完就测。
课后挑战

做一个ai

STEP 1

写提示词

用第 7 页的模板,让 AI 生成一个带输入框和对话区的单文件网页。

STEP 2

粘贴运行

打开在线编辑器,贴进 HTML 标签,确认预览区能正常显示界面。

STEP 3

填入并测试

填自己的免费密钥和模型名,发一条消息,看控制台有没有报错。

加分项(自选)

加上「清空对话」按钮和错误提示框,让别人也能用。

让页面在手机上也好看,试试预览区的 375px 宽度。

总结

三件事,带走就行

API 是一种约定

地址 + 凭证 + 内容,网页就能用上远端的 AI。

密钥一定要保密

不分享、不公开、不进分享链接。

报错是可以读懂的

看状态码,看 error.message,按顺序排查。

现在,回到第 10 页,亲手生成一份属于你的 HTML 吧。

01 / 15

课程目录