设置场景路由和定价

完成后,产品对外提供 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 场景,再点击一次 保存。

参考

下一步