Felo API PlatformFelo API Platform

指南

模型与价格

理解模型 ID、供应商、公布费率、折扣、计费单位,以及一次请求如何计价。

模型价格以美元公布。同一个模型可能通过多个上游供应商提供,每个供应商可以公布不同的客户价格。本指南说明这些价格的来源,以及如何在发送请求前估算费用。

查找模型 ID

使用 API 返回的模型 ID,不要根据显示名称或页面 slug 拼装 ID。

接口返回
GET /api/v1/models所有已启用的模型类别
GET /api/v1/videos/models视频生成模型
GET /api/v1/decisions/models决策模型

GET /api/v1/models 还接受 exclude_video_and_decisions=true 和可选的 provider 过滤参数。模型发现只读取目录,不会产生模型调用费用。

如需浏览,请打开模型目录或价格页。模型详情页会显示上下文限制、协议以及每个已公布供应商的价格。

供应商与渠道

每个模型都带有一组公开渠道。一个渠道是该模型的一种上游供应商配置,例如 Anthropic、Azure、Google,或某个折扣 Claude 渠道。

  • is_default 标记用于标价和默认路由的渠道。
  • runnable 标记该渠道当前是否可接受请求。
  • standard_pricing 包含供应商的标准费率。
  • discount_multiplier 是 0 到 1 之间的销售乘数。
  • pricing_mode 为 configured_rates 或 upstream_cost。

模型页的供应商排序为:默认渠道置顶,其余按客户输入价从低到高。要显式选择供应商,请参阅渠道与供应商路由。

客户价格的计算方式

对于 configured_rates 渠道:

客户价格 = 标准费率 × 折扣乘数

例如,某渠道的标准输入价为每 1M tokens $1.00,乘数为 0.8,则收取每 1M tokens $0.80。

对于 upstream_cost 渠道,standard_pricing 为 null,而不是 0。计费按上报的生成成本乘以冻结的折扣计算。模型页会显示该渠道的实际规则。

token 费率以每 100 万 tokens 展示,便于阅读。计费使用当前价格快照中的每 token 精度。

计费单位

单位典型用途计量方式
Tokens对话、推理、embedding、文本生成输入和输出 tokens 分别计量;缓存读取和写入可能有单独费率
Requests部分图片和工具类 endpoint每次调用固定收费
秒或档位视频生成时长、分辨率、参考输入或其他公布的条件

如果多个价格条件同时匹配,以模型价格详情中列出的第一个匹配条件为准。估算大任务前,请在模型详情页确认档位。

缓存费率

当模型公布 input_cache_read 或 input_cache_write 时,这些费率会出现在目录和模型页中。缓存用量由协议响应上报;缓存命中并不保证,取决于上游供应商和请求。Felo 不额外提供缓存开关。

在哪里查看价格

  • 价格页 — 对比模型与供应商。
  • 模型详情页 — 完整费率表、档位和条件。
  • 模型目录 API — 相同数据的 JSON,60 秒内刷新。

不要在应用里写死价格。读取目录,或在应用里链接到价格页,这样价格变化不会静默破坏你的成本估算。

估算一次请求

  1. 找到模型 ID 和计划使用的渠道。
  2. 读取该渠道的输入、输出和缓存费率。
  3. 乘以预计的 token 数;非 token 模型则使用请求或时长费率。
  4. 加上适用的条件档位。
  5. 为重试和输出波动留出余量。

相关