设置场景路由和定价
完成后,产品对外提供 chat、image-creation 等命名 AI 场景,每个场景路由到一个模型并按积分计价。
调用方按编码请求场景。每个场景路由到一个 Provider 场景,因此切换背后的模型不需要修改调用方。每次调用都按积分计价。积分在调用供应商前预留,成功时扣除,失败时退回。
准备工作
从服务商确认计费单位
先在当前模型的服务商控制台或官方价目表确认模型 ID、计费货币与单位。文本模型通常区分输入/输出 Token,图片或视频可能按请求、尺寸或时长计费。可参考 OpenAI 价格、Gemini 价格或 Workers AI 价格。兼容 HTTP 服务以其自己的合同或价目表为准。项目不会同步服务商价格。先把服务商价格换算成下文的 Provider 场景成本 或 Token 比率,再设加价率,并用一笔真实测试请求核对供应商账单与项目扣费。文中的示例数字不是服务商现价。
设置积分价格
打开默认规则
进入 设置 → AI 配置(/admin/config/ai),打开 默认规则。
填写全局默认值
在 全局默认 中填写 1 积分价格(一个积分值多少钱,例如 0.01)、加价率(百分比,例如 50)和 货币(例如 USD),然后点击 保存。
为 Provider 场景定价
打开 Provider 场景
打开 Provider,在 Provider 所在行点击 Provider 场景,再通过 配置 Provider 场景 打开模型。
选择计费模式
在 Provider 场景计费 中选择 计费模式:
- 固定积分:在 Provider 场景成本(按你的货币)中填写每次调用的成本,可选填 Provider 场景加价率(可选)。预览显示 成本积分 和 最终扣费。
- 按参数规则:按
size、duration等请求参数计费。选择 参数排列组合 时,为每个参数填写 参数名称、默认值 和 有效值列表,系统为每种组合生成一行价格,初始值取自 默认成本 和 默认加价率。选择 数值步长 时,填写 计费参数名、步长、每步成本 和 最少步数。 - Token 折算:用于文本模型。选择 按总 Token 统一折算 并填写 总 Token / 货币单位,或选择 输入 / 输出分别折算 并填写两个比率。对话在流式返回期间先预留估算积分,结束后按模型返回的 Token 用量扣费。
保存
点击 保存。/admin/ai/pricing 汇总了每个 Provider 场景最终的价格。
扣费积分 = 成本积分叠加加价率后向上取整,且不低于成本积分。加价率依次取 Provider 场景、Provider、默认规则 中的值。1 积分价格 为 0.01 时:
- 固定成本
0.04折合 4 成本积分,加价率 50% 时用户支付 6 积分。 - 总 Token / 货币单位 填
1000000时,每 10,000 Token 计 1 成本积分。一次 25,000 Token 的回复为 3 成本积分,加价率 50% 时扣 5 积分。
修改积分价格
成本在保存 Provider 场景时按当时的积分价格换算成积分并保存下来。之后如果修改了 1 积分价格,需要逐个打开 Provider 场景重新保存,否则用户仍按旧价格扣费。
创建场景并设置路由
添加场景
打开 场景路由,点击 添加场景,填写 显示名称、编码(例如 chat 或 image-creation)、输出类型、排序 和 状态,然后点击 保存。
选择模型
在场景所在行的 Provider 场景 下拉框中选择模型。下拉框只列出输出类型相同、已启用且可路由的 Provider 场景。如果还没有,点击 请先创建 Provider 场景,保存该表单时会自动完成路由。
徽标变为 当前路由。对话默认使用编码为 chat 的场景,除非请求指定了其他场景。任务通过 POST /api/<编码>/generate 调用,例如 /api/image-creation/generate。
验证
发送对话消息
以测试用户登录站点,在浏览器控制台运行:
await fetch("/api/chat", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({
messages: [{ id: "m1", role: "user", parts: [{ type: "text", text: "你好" }] }],
}),
}).then((response) => response.text());回复会流式返回,对话出现在 平台 → 对话(/admin/chats)中。
运行任务
用带 运行 AI 任务 权限范围的 API Key 调用任务场景:
curl -X POST https://your-domain.example/api/image-creation/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"木桌上的陶瓷马克杯","mediaType":"image","size":"1024x1024"}'响应中包含 taskId、status 和 estimatedPriceCredits。除 prompt、input、mediaType 等保留字段外,其余字段会作为 metadata 传给定价规则,因此上例的 size 可以用于 按参数规则 计费。
检查结果
- 用户的
/app/ai列出该任务,任务详情页显示积分的预留、扣除或退回情况。 - 平台 → AI Tasks(
/admin/ai)能看到该任务。失败任务及供应商错误在/admin/ai/failed中列出。 /setup中 AI 渠道 显示为就绪。
pnpm validate:ai 会运行文本和视频任务,检查积分和事件。pnpm validate:ai-channel 会检查定价和路由。
常见问题
任务报错 "AI scene is not available" 或 "AI provider is not available for this scene"
场景没有启用的路由,或路由到的 Provider 在请求的输出类型下没有启用的 Provider 场景。在 场景路由 中设置路由,并确认 Provider 和 Provider 场景都已启用。此时不会扣积分。
任务报错 "S06 insufficient credits"
用户可用余额低于价格。在 概览 → 用户 发放积分或调低价格。此时不会调用供应商。
用户仍按旧价格扣费
Provider 场景保存之后修改过积分价格。打开该 Provider 场景,再点击一次 保存。