企业官网建设流程全解析

把个人小程序接进微信 AI 生态，最小调用链上真正缺的往往只有两样东西：一个能长期用的 Key，和一个稳定的请求地址。TaoToken（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_intro）补的就是这一段：官网拿 Key，请求地址统一写 https://taotoken.net/api。很多同学第一次做，会直接在小程序里wx.request打模型接口，然后立刻收到request:fail url not in domain list；就算域名加进了白名单，把 Key 硬编码进小程序包，也会在代码安全扫描环节被拦下来。所以真正可复现的最小步骤，不是「在小程序前端调模型」，而是「小程序只负责收输入和渲染输出，服务端持 Key 转发到网关」。这条链路一旦跑通，后面无论是换成流式输出、加内容安全校验，还是接进微信 AI 场景，都只是在这条链路上加节点，而不是重写架构。

下面这篇按「最小步骤清单 → 请求模板 → 调试日志 → 开发者工具配置 → 上线前检查」的顺序写，每一步都能本地复现，不需要改动你现有的小程序页面结构。

1. 最小调用链拆解：为什么 Key 只能落在服务端

先把链路画清楚，后面所有报错都能对上号。个人小程序接 AI，最小可用链路是四段：

1. 小程序端：收集用户输入（文本框、按钮、语音转写结果都行），通过wx.cloud.callFunction或wx.request把文本发出去。
2. 你的服务端：微信云函数、CloudBase、自建 Node 服务、甚至一台轻量服务器都可以，它持有 Key。
3. 模型网关：请求地址填https://taotoken.net/api，携带Authorization: Bearer YOUR_API_KEY。
4. 回程：服务端拿到结果，裁剪成小程序需要的最小字段（一般只要content和一个可选的usage），返回给页面。

为什么第 2 段不能省？三个原因，都是硬约束。

第一，域名白名单。小程序wx.request只能请求在「开发管理 → 开发设置 → 服务器域名 → request 合法域名」里配置过的 HTTPS 域名，且域名需要完成 ICP 备案。你当然可以去配，但一旦以后换供应商，就要重新走配置流程；用云函数callFunction则完全不走这套域名校验，改地址只改服务端一行环境变量。

第二，Key 的暴露面。小程序包是可以被反编译的，任何写进app.js或config.js的字符串都等于公开。Key 一旦泄漏，被刷的是你的账单，不是别人的。服务端持有 Key，小程序端连 Key 的影子都看不到，这是唯一正确的姿势。

第三，可观测性。服务端的日志能记录请求时间、模型、耗时、错误码；小程序端只能拿到一个笼统的errMsg。排障效率差一个数量级。

还有一个容易忽略的点：小程序端默认超时和云函数默认超时不一致。wx.request的timeout可以在调用时指定，但云函数默认超时通常只有 3 秒，需要改成 60 秒（云开发在config.json里配"timeout": 60），否则你会看到一个特别迷惑的现象——本地curl两秒返回，小程序里永远「请求失败」。这个坑在「最小步骤」里就必须解决，不要留到上线后。

2. 最小步骤清单：从零到跑通一共 7 步

这 7 步就是本文承诺的「最小步骤清单」，建议按顺序执行，每一步都有明确的验收标准。

第 1 步：拿 Key。打开 TaoToken 官网（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_step1），进入控制台的 API Keys 页面创建一把 Key。创建后立刻复制，页面刷新后通常不再完整展示。把 Key 记在密码管理器里，不要贴在聊天窗口。

第 2 步：记下请求地址。所有调用统一走https://taotoken.net/api。这个地址是后面所有配置的唯一变量，云函数、Node 服务、Claude Code、Codex 都用它，只是路径拼接方式略有差别。

第 3 步：把 Key 放进环境变量，而不是代码。微信云开发在「云函数 → 配置 → 环境变量」里加TAOTOKEN_API_KEY，值填你自己的 Key；自建 Node 服务用.env+dotenv。仓库里只留YOUR_API_KEY占位符，永远不要提交真实 Key。

第 4 步：写请求模板。复制第 3 节的代码，改两处：环境变量名、模型 ID（模型 ID 在模型对话页能查到，先用一个你确认可用的）。

第 5 步：本地curl验证。这一步不要跳过，它能帮你把「Key 无效」「模型名写错」「网络不通」三类问题在小程序之外解决掉。

第 6 步：小程序端接云函数。页面里用wx.cloud.callFunction调，拿到result.content渲染。注意加loading状态和失败提示，否则用户点一次没反应会连点。

第 7 步：加日志并回归。按第 4 节的模板打三条日志，再跑一次正常请求 + 一次故意传错 Key 的请求，确认日志能区分两者。

验收标准很简单：清空本地缓存，用真机扫码，输入一句话，3 秒内出现回答；打开云函数日志，能看到一条带requestId的成功记录。

3. 请求模板：Node 云函数里把 Base URL 指向 TaoToken

下面这份代码可以直接放进微信云开发的云函数目录，也可以放在自建 Node 服务里（去掉wx-server-sdk相关两行即可）。关键点有三个：地址走环境变量、Key 只从环境变量读、返回给小程序前做字段裁剪。

{ "permissions": { "openapi": [] }, "timeout": 60 }

上面是云函数的config.json，重点是timeout改成 60，避免长回答被云函数默认超时截断。

// cloudfunctions/aiChat/index.js const cloud = require('wx-server-sdk') cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV }) // 请求地址统一走 TaoToken 网关 const BASE_URL = process.env.TAOTOKEN_BASE_URL || 'https://taotoken.net/api' const API_KEY = process.env.TAOTOKEN_API_KEY || 'YOUR_API_KEY' const MODEL_ID = process.env.TAOTOKEN_MODEL || 'YOUR_MODEL_ID' exports.main = async (event) => { const prompt = (event && event.prompt ? String(event.prompt) : '').trim() if (!prompt) { return { ok: false, code: 'EMPTY_PROMPT', msg: '输入为空' } } if (prompt.length > 500) { return { ok: false, code: 'TOO_LONG', msg: '输入过长' } } const startedAt = Date.now() // 日志一：请求前，确认地址与模型 console.log('[aiChat][req]', { baseUrl: BASE_URL, model: MODEL_ID, keyTail: API_KEY.slice(-4), promptLen: prompt.length }) const controller = new AbortController() const timer = setTimeout(() => controller.abort(), 45000) try { const res = await fetch(`${BASE_URL}/v1/chat/completions`, { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${API_KEY}` }, body: JSON.stringify({ model: MODEL_ID, messages: [ { role: 'system', content: '你是小程序内的助手，回答控制在 150 字以内。' }, { role: 'user', content: prompt } ], max_tokens: 512, temperature: 0.6 }), signal: controller.signal }) const requestId = res.headers.get('x-request-id') || res.headers.get('request-id') || '' // 日志二：响应后，确认状态码与链路 ID console.log('[aiChat][res]', { status: res.status, requestId, costMs: Date.now() - startedAt }) if (!res.ok) { const text = await res.text() return { ok: false, code: 'UPSTREAM_' + res.status, msg: text.slice(0, 300) } } const data = await res.json() const content = data && data.choices && data.choices[0] && data.choices[0].message ? data.choices[0].message.content : '' return { ok: true, content, usage: (data && data.usage) || null, requestId, costMs: Date.now() - startedAt } } catch (err) { // 日志三：异常，区分超时与其它错误 const isAbort = err && err.name === 'AbortError' console.error('[aiChat][err]', { name: err && err.name, message: err && err.message, isAbort, costMs: Date.now() - startedAt }) return { ok: false, code: isAbort ? 'TIMEOUT' : 'NETWORK', msg: isAbort ? '模型响应超时，请重试' : '网络异常' } } finally { clearTimeout(timer) } }

小程序页面里这样调，注意只传 prompt，不要在前端拼接任何和 Key 有关的东西：

// pages/chat/chat.js Page({ data: { input: '', answer: '', loading: false }, onInput(e) { this.setData({ input: e.detail.value }) }, async onAsk() { if (this.data.loading) return const prompt = this.data.input.trim() if (!prompt) return this.setData({ loading: true, answer: '' }) try { const res = await wx.cloud.callFunction({ name: 'aiChat', data: { prompt } }) const r = res.result || {} this.setData({ answer: r.ok ? r.content : `[${r.code}] ${r.msg || '请求失败'}` }) } catch (e) { this.setData({ answer: '[CLIENT] 调用云函数失败：' + (e.errMsg || '') }) } finally { this.setData({ loading: false }) } } })

如果你不用云开发、坚持自建服务，那小程序端换成wx.request，同时必须把服务域名加进 request 合法域名，并且服务地址必须是 HTTPS。请求模板不变，只是把BASE_URL从前端挪到服务端的配置文件里——Key 依然不能出现在小程序里。

关于流式输出再补一句：小程序不支持EventSource，但基础库较高版本支持wx.request的enableChunked: true分块接收。云函数场景下更省事的做法是先做非流式，等链路稳定再考虑「云函数聚合 + 分段返回」或前端直连你的自建 SSE 服务。不要在最小步骤阶段就上流式，排障成本会翻倍。

4. 调试日志：三条日志定位绝大多数问题

「最小步骤」的可复现产出里，调试日志和步骤清单同样重要。上面模板里埋的三条日志，分别对应三个排查维度：

• [aiChat][req]：证明请求发出去了，baseUrl和model打印出来，能一眼看出是不是地址写成了别的域名、模型 ID 有没有配置成功。keyTail只打印后四位，用来确认环境变量有没有读进来，同时避免泄漏。
• [aiChat][res]：拿到状态码和requestId。requestId是排障时最有用的东西，本地curl和线上日志可以用它对齐同一次请求。
• [aiChat][err]：区分超时（AbortError）和网络异常。超时通常是 max_tokens 给太大、或者模型本身响应慢；网络异常则要检查云函数是否绑定了 VPC、出口是否正常。

再给一份本地验证用的curl，放在服务端跑，不进小程序：

curl -sS -X POST "https://taotoken.net/api/v1/chat/completions" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "YOUR_MODEL_ID", "messages": [{"role": "user", "content": "只回复两个字：收到"}], "max_tokens": 32 }'

常见报错和处置顺序，按这个表对照就行：

这里特别提醒重试：只对429和5xx做重试，401、400重试多少次都一样，只会浪费额度。重试次数上限设成 2 次，并且加requestId去重日志。

5. 开发者工具侧配置：Claude Code / Codex / CC Switch 三件套

小程序只是接入的一端，日常写代码时你大概率还会用到命令行工具。它们和小程序共用同一个请求地址https://taotoken.net/api，但配置文件完全不同，别混用。

Claude Code 改settings.json，走 Anthropic 变量：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID", "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_MODEL_ID" } }

Codex 改config.toml，用 OpenAI 风格配置，注意这里不要出现ANTHROPIC_*：

model = "YOUR_MODEL_ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api/v1" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

对应地把TAOTOKEN_API_KEY写进 shell 环境变量：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

如果你用 CC Switch 这类切换工具，记住「三件套」要同时改，缺一个就会切不干净：

1. 供应商地址：统一填https://taotoken.net/api（OpenAI 兼容路径再接/v1）。
2. API Key：填你的 Key，不要填旧供应商的 Key。
3. 模型映射：把默认模型和快速模型都指到你确认可用的模型 ID 上。

切换完做一次验证：命令行发一句话，能返回内容说明三件套都生效了；如果返回 401，多半是第 2 项没改；返回 404，多半是第 1 项少了或多了路径段。

6. 小程序上线前检查清单

链路跑通不等于可以上线，还有几项在小程序侧必须确认：

• 域名与协议：自建服务必须是 HTTPS，且完成备案；用云函数则跳过这一条。
• 超时设置：前端wx.request的timeout与云函数timeout要对齐，建议前端 45 秒、云函数 60 秒，中间留缓冲。
• 内容安全：用户输入和模型输出都建议过一遍微信的内容安全接口（msgSecCheck），尤其是 UGC 类小程序。这一步放在服务端做，不要放在前端。
• 降级策略：模型侧返回429或超时时，给用户一个明确的「稍后重试」提示，而不是空白。可以在服务端缓存一段兜底话术。
• Key 轮换：Key 只存在服务端环境变量里，换 Key 时只改配置不发版。建议在控制台保留两把 Key，一把主力一把备用。
• 日志脱敏：日志里不要打印完整 Key 和完整用户输入，只留keyTail和长度。

把这六条过完，你这个个人小程序就算真正接入了微信生态的 AI 能力，而且是从「可复现」而不是「碰运气」的角度接进去的。

7. 排障顺序与下一步

最后给一个固定的排障顺序，遇到问题按这个走，比到处搜报错快得多：

1. 服务端curl直接打https://taotoken.net/api/v1/chat/completions，先确认 Key 和模型 ID 没问题。
2. 云函数里单独调用，看[aiChat][req]和[aiChat][res]两条日志。
3. 小程序端callFunction，看返回结构是不是ok: true。
4. 页面渲染，检查数据绑定字段对不对（最常见的就是把content写成了text）。
5. 真机回归，清缓存再跑一次。

整个「最小步骤」到这里就闭环了：Key 从官网拿，请求地址统一用https://taotoken.net/api，服务端持 Key，小程序只做展示。剩下的事情——换模型、加流式、做多轮会话——都是在同一条链路上做增量。

如果你还没开始，建议按这个顺序走一遍：先在模型对话页把模型跑通，确认它符合你的场景；再根据自己的调用量选择 Coding Plan；然后回到控制台创建 API Key（https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_keys）；最后打开 Claude Code 文档（https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_ccdoc），把settings.json按第 5 节改好。三个入口分别是：

• 模型对话先试跑：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_chat
• 按用量选套餐：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_plan
• 创建 API Key：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_keys
• Claude Code 配置文档：https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_ccdoc

官网总入口放在这里备查（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=wx_miniapp_end），Key 相关的操作都在控制台完成。把第 2 节的 7 步走完，把第 4 节的三条日志加上，你的个人小程序就已经具备了一条稳定、可观测、可替换模型的 AI 调用链。