生图会话管理

更新时间: 2025-01-09 10:57:48

接入指引

适用场景

不想开发前端页面,期望直接集成 Automatic1111-WebUI、ComfyUI 或小工具页面到自己的业务场景中。

具体需要做以下事情

  • 创建应用,获取 AK/SK:创建应用

  • 完成 SDK 对接:SDK参考

  • 对接 Token/Session 相关接口,用于账号绑定和终端用户使用生命周期管理,大多数场景仅需对接以下两个接口,Token 和 Session 详细概念详见下一小节。

    • 分配Token 用于跟终端用户账号绑定,一个 Token 绑定一个账号

    • 创建或刷新Session 用于管理特定 Token 使用服务生命周期,确保用户能够在限定时间内访问智作工坊的生图功能或其他服务。

  • 自定义域名:如果想对终端用户暴露自有域名,需要在应用配置设置自定义域名(WebUI域名),如直接使用我们提供的页面地址对终端用户提供服务,则可略过该步骤

核心概念

TOKEN

TOKEN 是一种用于身份认证和终端用户管理的数字凭证,在智作工坊的 UI 服务(WebUI、ComfyUI、小工具 UI)中,Token 主要用于帮助 B 端客户绑定其终端用户(C),以实现访问 UI 服务时用户身份识别以及用户行为跟踪。

您可以通过调用生成 TOKEN 的API服务来创建 TOKEN。创建完 TOKEN 后,您可以将对应 TOKEN 与自己的一个用户账户进行绑定。每个 TOKEN 都有自己的个性化信息以及生图创作历史。注意切忌将一个TOKEN 绑定多个用户,否则会出现生图界面混乱、模型收藏数据、生图历史隐私泄露等问题。

会话(SESSION)

会话(SESSION) 是一种用于管理用户访问状态的临时交互实例,在智作工坊的 UI 服务中,通过特定 Token 创建或刷新会话,可以为终端用户 (C) 提供受控的访问环境。

基于特定 Token 创建会话后,系统会返回一个用于终端用户 (C) 访问的 UI 使用环境地址,确保用户能够在限定时间内访问智作工坊的生图功能或其他服务。

会话具有时效性,创建或刷新时可以设置访问期限,避免因地址长期有效导致的潜在数据泄露或安全风险。

交互流程

image

接口清单

Token管理

Session管理

上一篇: API授权 下一篇: Token管理