全部产品
Search
文档中心

智能媒体管理:WebOffice计费说明

更新时间:Aug 28, 2026

2023-12-01 起,WebOffice 对新建项目的计费方式由按文档打开次数改为按API接口调用次数,涉及接口为获取Weboffice凭证和刷新Weboffice凭证。此前创建的项目不受影响,仍按打开次数计费。

计费逻辑对比

  • 打开计费(2023-12-01 之前创建的项目):文件打开后与服务端建立长连接,连接断开时产生一次计费。token 不限时长、不限用户数量,同一个 token 可供多用户多次打开文档,每次打开均单独计费。

  • 接口计费(2023-12-01 之后创建的项目):每次调用 GenerateWebofficeToken 或 RefreshWebofficeToken 产生一次计费。单次调用获取一个 token,该 token 有效期为 30 分钟,有效期内可重复打开文档,不重复计费。每个 token 仅限单用户使用——若多个用户同时使用同一 token 打开同一文档,仅最后发起请求的用户能正常打开,之前用户的访问权限将被收回。为避免此问题,每次打开文档时应为对应用户获取独立的 token。

下表对比两种计费模式的关键差异:

对比项

打开计费(2023-12-01 之前)

接口计费(2023-12-01 之后)

适用项目

2023-12-01 之前创建的项目

2023-12-01 之后创建的项目

计费时机

用户打开文档后连接断开

调用 GenerateWebofficeToken 或 RefreshWebofficeToken

token 有效期

不限时长

30 分钟

用户限制

不限制,同一 token 可多用户共用

单用户,不同用户须使用不同 token

token 有效期内重复打开

每次打开均计费

仅首次调用计费,有效期内重复打开不再计费

切换接口计费方案

切换至接口计费方案,需创建新项目并更新集成代码。

  1. 在 IMM 控制台创建新项目,新项目默认使用接口计费模式。

  2. 修改代码逻辑:每次用户打开文档时,调用 GenerateWebofficeToken 获取新的 token,并将该 token 仅传递给发起请求的用户,不在多用户间共用。

    // 每次文档打开请求时生成新 token
    token = GenerateWebofficeToken(project=<new-project-id>, ...)
    // 将 token 仅传递给当前请求的用户
  3. 将API调用中的 project 参数更新为新项目的 ID。