访问令牌
访问令牌是调用模力方舟 API 的身份凭证,支持精细化权限控制,涵盖个人及组织场景,与资源包调用密切关联,以下为详细说明:
创建访问令牌
-
点击「+ 新建访问令牌」,填写令牌名称(如“个人项目调用”)。
-
选择授权范围:
授权全部资源:可访问您购买的所有 Serverless API 资源包,包括后续新购资源,如果无需指定固定资源包,建议使用该方式。
授权部分资源:手动勾选特定资源包(如仅选“全模型资源包”“沐曦资源包” ),仅允许调用该资源包包含的模型接口。
优先使用 Token 计费:部分模型同时支持按次和按 Token 数计费,勾选此项后,使用令牌调用的对应模型将按 Token 数计费,否则默认按次计费,您可根据自身调用情况决定是否勾选,以最大化降低成本。
注意
-
系统默认会创建"免费体验访问令牌",该令牌用于给用户体验使用,无法编辑或删除,无需购买资源即可体验接口调用,使用该令牌不会产生任何扣费。该令牌体验次数有限制,请勿用于生产环境,如需正式使用请购买资源使用付费令牌。
-
资源用量不足30%、10%、0时会通过站内信息和邮件提醒用户,收到提醒后建议尽早续费,避免影响后续使用。
编辑访问令牌
已创建的令牌支持修改:
- 名称:直接编辑令牌标识;
- 资源授权:切换“全部资源/部分资源”,重新勾选授权的资源包;
临时令牌生成
为提升客户端使用安全性,可生成短期有效的临时令牌:
- 使用已创建的访问令牌,调用API生成临时令牌,详情请看 创建临时访问令牌 。
- 临时令牌默认有效期为 1 小时,可在接口中指定过期时间(最长 24 小时)。
- 用途:适用于前端页面、客户端直接调用 API 场景,避免长期令牌泄露。
注意
- 创建的临时令牌是绑定在创建临时令牌鉴权的"访问令牌"上,因此该"访问令牌"权限变更及删除操作都会影响到临时令牌。建议单独创建一个"访问令牌"用于生成临时令牌,并且避免变更该令牌。
组织访问令牌
组织访问令牌用于调用组织名下的资源,由管理员统一创建和管理
- 进入 组织工作台 > 设置 > 访问令牌 页面。
- 点击「+ 新建组织令牌」,选择授权的资源范围(同个人令牌)。
- 令牌创建后,可共享给组织成员用于 API 调用,但仅能访问组织资源。
- 管理员可在令牌列表中查看调用记录,或禁用异常令牌。
权限控制说明
- 个人访问令牌仅能访问您的个人资源,无法操作组织资源。
- 若令牌关联的资源包过期或用尽,调用 API 时将返回「资源未授权」错误。
- 可在「访问令牌」页面随时禁用或删除令牌,立即终止其有效性。