用量

用恰当的计量单位、统计周期和执行证据,说明工作量消耗与账户支出。

用量将支出与背后的工作对应起来。账户历史记录说明组织在某段时间内消耗了哪些资源;模型和词元记录解释生成过程;各次运行记录则显示哪些操作已完成、已重试,或沿用了先前的输出。这些记录相互关联,但各自的总量不能混为一谈。

先明确要核算的问题 #

选择要核对的组织和周期,再查看相应的支出历史记录。通过模型成本和词元用量的时间序列数据,了解支出背后的工作;通过运行证据或成本,查看具体执行情况。比较总量时,请保持筛选条件、日期范围和时区一致。

目标语言区域增多、生成新输出、重试或复用方式变化,都可能增加模型词元用量。但词元用量的增加本身,并不能解释账单的全部变化。将差异归因于某个模型之前,请先把观察到的工作与相应的收费类别对应起来。

实际观测到的成本和输出词元用量,可用于估算未来类似工作的消耗。但这些数据不能充当提供商价目表、账单或费率保证。账单涵盖余额、购买、付款和套餐状态。

保留各自的计量单位 #

计量项衡量的内容
输入和输出词元依据所报告的提供商定义计量的模型工作量。
缓存读取和缓存写入词元提供商的缓存活动,其计量值可能与总输入量重叠。
积分和货币依据当前商业合同进行的核算。
请求数、字词数或代码仓库行数不同的工作量指标,统计对象也各不相同。

不要把缓存计数与总输入量视为互不重叠的数据,直接相加;也不要将所有输入都标记为全新输入。提示词缓存说明了如何解读这些存在重叠的计量值。

提供商成本、本地化费用、专业审核、独立测量和平台套餐是彼此独立的组成部分。确定性检查可能不消耗任何模型词元,却仍会产生按量计费的测量用量。复用翻译可以省去生成环节,但不代表所有相关操作都免费。

比较成本时,请确保内容、语言覆盖范围、审核覆盖范围和验收要求具有可比性。还应计入检查和处理输出所需的工作,而不是将词元用量的差异直接视为固定的总成本节省。

按问题选择合适的报告 #

工作量报告展示生成量及其在不同语言和来源中的分布。代码仓库变更证据取决于相应的集成,不能代表所有内容系统。

质量报告应在结果旁列明判定标准和统计分母。不适用的记录无法对该标准给出答案。结果无法判定,表示评估已完成,但未能确定质量是否保持不变或发生变化;尚未完成评估的记录则是另一种情况。报告通过率和完成情况时,也应同时报告可判定结果的覆盖率。

对于术语和规则,应区分候选项或样本与实际使用及遵循情况。评估结果说明了相关计数。

再次执行前,先排查受阻或部分完成的工作 #

重试或购买积分前,请先查看实际错误。校验、身份验证、授权、资源缺失、积分限制和配额限制,各有不同的成因。在适用的 API 中,常见错误码依次为 400、401、403、404、402 和 429,但具体修复方式应以该操作声明的错误及其消息为准。本地化引擎被禁用、缺少必填 ID、缺少模型配置,以及受到上游提供商限制,也需要分别处理。

重试是否安全,取决于操作本身及其幂等性。通用服务器错误并不能证明首次请求未执行任何工作。只有确认操作可以重试,并查明先前哪些工作已被接受后,才应采用有上限的退避重试。

对于翻译任务,创建操作会保存一个待处理的任务。启动请求成功后,工作才会开始,但该响应仍不代表翻译已完成。请检查各目标的处理结果、警告和保留的文本;在替换部分完成的工作之前,先核对实际执行的内容及相应费用。