API 怎么实现预览功能?价格怎么算?

我看到 API 参数里有个 previewCredits。参数的说明是:“支付用于预览的积分。如果账户余额不足,则创建失败。服务端会自动根据积分计算需要翻译的 token 量进行翻译。如果用于预览的积分大于文档所需积分,则会完整翻译整篇文档。当传入 previewCredits 后, fastCreation 和 autoStart 都不再生效。”

具体是怎么使用的?

另外就是这个预览积分怎么算价格的?

API
价格说明
回答于 2024-08-21

通过 API 翻译文档,服务器端正常的流程就是,分析文档计价,然后检测用户积分余额是否足够,如果足够就直接扣积分完整翻译,不足就提示不足并让这个翻译任务处在“待支付(Unpaid)”的状态。

此时的“待支付”文档只是经过了分析,还完全没有翻译的。不像在我们的网页端上传文档,有一些免费翻译额度

预览翻译流程

如果想要通过 API 实现预览,就可以在创建任务时,提供预览积分(previewCredits)。

此时,服务器端的流程就变成了:检测用户积分余额是否大于或等于制定的预览积分,扣除预览积分,并且在分析完文档之后,直接翻译积分指定的量。预览翻译完后,任务处在 PreviewCompleted 状态。

因此,API 的客户端如果要实现像我们网页端一样的先预览在完整翻译的流程,可以按照以下的步骤:

  • POST 创建任务时指定 previewCredits

  • 等任务处在 PreviewCompleted 时,给客户端用户确认翻译效果

  • 在客户端用户确认完毕后,可以再通过 PUT 启动翻译任务来进行完整翻译

价格计算

预览积分的价格跟正常翻译时一样的。

参考价格说明

假设该模型的正常价格是 3000 token 一积分,因为有 1 积分的基础价格用于文档分析,通常来说预览积分就是 2 积分起。

2 积分可以翻译 3000 token,3 积分可以翻译 6000 token,依次类推。

假设一份文档完整翻译需要 11 积分,如果已经使用了 3 积分翻译前 6000 token,那么此时就只需要 11 - 3 = 8 积分完整翻译剩下的内容。

但按照目前的流程,如果预览积分比文档完整翻译的价格高的话,也不会退回:假设是一份文档完整翻译需要 3 积分,创建任务时指定了 previewCredits=4 而且用户余额足够,就会直接扣除 4 积分完整翻译。

|
|
知乎机构号
© 深圳市群蜂信息技术有限公司 2020-2023
粤ICP备2021006232号