服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 当前模型为 27B 的 pplx-decider-v1.2 与 4B 的 pplx-decider-flash-v1.2,输入单价分别为每百万 tokens 0.02 与 0.01 美元。
- pplx-decider-latest 与 pplx-decider-flash-latest 是有效别名;旧 v1/v1.1 请求名继续可用并选择 v1.2。响应 model 只是回显请求名,不能证明实际服务版本。
- v1.2 按问题组计算 state,Flash 则每个问题各算一次;输入单价减半不代表整个任务费用减半。
- noul、choice、score 适合判断、分类与有序评分。模型或分组变化后应复核阈值,重要操作保留业务授权与人工复核。
旧模型名现在会选择哪个版本?
当前官方快速入门说明,pplx-decider-v1-27b 与 pplx-decider-v1.1-27b 仍可请求,但都会选择 pplx-decider-v1.2,并按 v1.2 的费率计算。沿用旧名称,不等于服务端仍运行旧模型。
官方更新日志把这次替换列在 2026 年 10 月,未给出准确日期与时区。本文于 11 月 3 日按当前文档修订,不把查阅日写成新模型首发日。
这意味着已有评论分类或客服分流流程也应重新检查结果。接口继续返回成功,只能证明请求完成,不能证明旧有分类边界与概率阈值仍适用。
先按任务选类型,再决定模型
noul 回答是否符合条件,返回肯定答案的概率;choice 从给定选项中选择并返回各选项概率;score 对有顺序的等级评分。它们输出结构化判断,不会替你生成解释或客服回复。
例如,假设买家说“外观不错,但充电口完全无法使用”。可以判断是否报告故障、该送到产品还是物流队列,以及问题严重程度。这个例子用于说明问题设计,没有实际执行 API 调用。
当前 v1.2 为 27B,Flash v1.2 为 4B,两者支持文字和图片、256K 上下文、最多 255 个 choice 选项或 10 个 score 等级。先用有权限处理的标注样本比较误分,再选择符合准确性要求的模型;参数更大或单位价格更低,都不能代替自己的验证。
latest 别名可用,但响应名不能证明服务版本
pplx-decider-latest 与 pplx-decider-flash-latest 会跟随各自的最新模型。文档也接受 perplexity/pplx-decider-latest 与 perplexity/pplx-decider-flash-latest;版本退役后的名称会路由到替代版本,并在更新日志说明。
响应中的 model 回显你传入的名称。请求填 pplx-decider-latest,响应仍显示这个别名,不会因此告诉你实际使用的版本;请求写旧版本名,也不能靠回显判断仍在使用旧权重。
记录请求模型名、问题定义、分组方式与结果,并在官方路由变化后重新校验阈值。需要复现判断时,要同时核对服务端版本策略,不能仅把请求字符串当作固定版本保证。
Flash 单价减半,为什么多问题可能更贵?
当前输入价格为 v1.2 每百万 tokens 0.02 美元、Flash v1.2 每百万 tokens 0.01 美元;输出免费,没有按请求收费。别名按实际选择的模型费率计费,费用归属于 API key 所属组织。实际输入量看 usage.input_tokens。
v1.2 通常把同一请求的问题一起判断,state 在每个问题组中计算一次。若 state 加全部问题超过输入上限,接口会拆成连续问题组,每组再次计算 state;如果 state 加单个问题也超过上限,则返回 400。
Flash 对每个问题独立判断,同一份 state 会为每个问题再次计算。假设 state 有 10,000 个 tokens、要问 3 个问题,暂不计问题本身的 tokens:v1.2 若能放在一组,state 部分约为 0.0002 美元;Flash 的 state 部分约为 30,000 个 tokens,约 0.0003 美元。这只是算术示例,未调用接口,也不是最终账单。
预算要结合正文、问题和图片的实际输入量、分组与费率。多个问题不一定适合合在一起:分组本身也可能改变概率,因此不能只为省 tokens 随意合并独立候选。
接入、图片与错误处理要核对什么?
接口为 POST https://api.perplexity.ai/v1/decisions,鉴权使用 Authorization: Bearer。state 放入内容,questions 定义问题,model 每次显式填写。文档说明有效的 Perplexity API key 可用于此接口;请核对所属组织与账单权限,把 key 留在服务端或安全配置中。
图片输入使用 PNG、JPEG 或 WebP 的 base64 data URL,普通 HTTPS 图片链接不受支持。每个问题最多 8 张图片,请求体上限为 32 MiB,问题数量为 1–128;还要同时满足图片尺寸和输入 token 限制,完整字段以官方文档为准。
默认组织级限速为每秒 10 个请求,由两种模型共享;各模型还分别有 token 限制。429 按 Retry-After 等待并限制重试次数,不把换同一组织的 key 当成扩容方法。
先检查 HTTP 状态,再读取 error.message 与 error.type,不只依赖类型不固定的 error.code。401 检查 Bearer 与 key,404 检查准确路径和末尾斜杠;超时或输入错误不是“没有问题”的分类结果。
怎样复核已有分流流程?
先固定一组允许处理的样本与正确标签,覆盖边界案例和信息不足的情况。对照当前请求名与官方路由,保持问题、选项及分组方式一致,再检查错误类别与需要人工复核的结果。
同一个问题与不同问题放在一起时,概率可能变化。比较模型或调整阈值时,应固定分组;独立文档或相互竞争的候选,按官方建议优先分别判断,而不是假定一个批次内的结果彼此独立。
choice 和 score 的 confidence 是由模型概率计算的确定程度,不是业务实测准确率。分类可先送到队列,退款、权限与重要账号动作仍需要各自的业务条件和授权;拿到一个分类结果,不等于可以直接执行操作。
资料来源
常见问题
它会先搜索网页,再替我分类吗?
Decisions API 判断的是 state 中提供的内容。若流程需要先检索网页或商品资料,应另行安排允许的取数步骤,再交给分类环节;不要把搜索、生成回复与结构化判断视为同一能力。
score 返回 1.7,是 1.7% 吗?
不是。score 是等级索引的概率加权平均。例如等级按 0、1、2 编号,1.7 位于后两档之间;结合 legend 与 probabilities 解读,不能直接当作百分比或五星评分。
托管 API 换模型,会自动更新本地权重吗?
不会据此自动更新你保存的模型文件。托管接口的路由策略与自部署是两件事;旧 v1.1 权重的许可证、模型卡和硬件要求也不能直接套到 v1.2 或 Flash。本篇没有核验这两种新版本的自部署可用性或做本地性能测试。