跳到主要内容

访问令牌

访问令牌是调用模力方舟 API 的身份凭证,支持精细化权限控制,涵盖个人及组织场景,与资源包调用密切关联,以下为详细说明:

创建访问令牌

  1. 进入 工作台->设置->访问令牌

  2. 点击「+ 新建访问令牌」,填写令牌名称(如“个人项目调用”)。

  3. 选择授权范围:

    授权全部资源:可访问您购买的所有 Serverless API 资源包,包括后续新购资源,如果无需指定固定资源包,建议使用该方式。

    授权部分资源:手动勾选特定资源包(如仅选“全模型资源包”“沐曦资源包” ),仅允许调用该资源包包含的模型接口。

    image

    优先使用 Token 计费:部分模型同时支持按次和按 Token 数计费,勾选此项后,使用令牌调用的对应模型将按 Token 数计费,否则默认按次计费,您可根据自身调用情况决定是否勾选,以最大化降低成本。

注意
  1. 系统默认会创建"免费体验访问令牌",该令牌用于给用户体验使用,无法编辑或删除,无需购买资源即可体验接口调用,使用该令牌不会产生任何扣费。该令牌体验次数有限制,请勿用于生产环境,如需正式使用请购买资源使用付费令牌。

  2. 资源用量不足30%、10%、0时会通过站内信息和邮件提醒用户,收到提醒后建议尽早续费,避免影响后续使用。

编辑访问令牌

已创建的令牌支持修改:

  • 名称:直接编辑令牌标识;
  • 资源授权:切换“全部资源/部分资源”,重新勾选授权的资源包;

image

临时令牌生成

为提升客户端使用安全性,可生成短期有效的临时令牌:

  1. 使用已创建的访问令牌,调用API生成临时令牌,详情请看 创建临时访问令牌
  2. 临时令牌默认有效期为 1 小时,可在接口中指定过期时间(最长 24 小时)。
  3. 用途:适用于前端页面、客户端直接调用 API 场景,避免长期令牌泄露。
注意
  1. 创建的临时令牌是绑定在创建临时令牌鉴权的"访问令牌"上,因此该"访问令牌"权限变更及删除操作都会影响到临时令牌。建议单独创建一个"访问令牌"用于生成临时令牌,并且避免变更该令牌。

组织访问令牌

组织访问令牌用于调用组织名下的资源,由管理员统一创建和管理

  1. 进入 组织工作台 > 设置 > 访问令牌 页面。
  2. 点击「+ 新建组织令牌」,选择授权的资源范围(同个人令牌)。
  3. 令牌创建后,可共享给组织成员用于 API 调用,但仅能访问组织资源。
  4. 管理员可在令牌列表中查看调用记录,或禁用异常令牌。

权限控制说明

  • 个人访问令牌仅能访问您的个人资源,无法操作组织资源。
  • 若令牌关联的资源包过期或用尽,调用 API 时将返回「资源未授权」错误。
  • 可在「访问令牌」页面随时禁用或删除令牌,立即终止其有效性。