场景指南
provider env 管理
如何集中管理模型供应商 key 和 base_url。
provider key 是 Base 的职责。client 不应该知道，也不应该通过构建变量暴露。
handler 直接读取 env
模型记录现在只保存 provider、上游模型和 config。真正的 key 仍然从 Base 的 .env 读取：
base.text()
.default({ model: "gpt-5.4" })
.handle(async (ctx) => {
const apiKey = ctx.env.OPENAI_API_KEY;
return openai.responses.create({
model: ctx.model.upstream_model,
input: ctx.query.prompt,
apiKey,
baseURL: ctx.env.OPENAI_BASE_URL,
});
});管理 env
可信服务可以通过 AdminClient.env 管理 Runtime env。
await admin.env.upsert({
key: "OPENAI_API_KEY",
value: "sk_xxx",
});多个产品共用 Base 时，env 只需要维护一份。