更新时间:2025-07-01 GMT+08:00

进阶使用:使用API模式访问应用

通过应用中心部署的Stable Diffusion应用默认未启用API访问,可以通过配置函数环境变量的方式启用。

使用API模式访问应用

  1. 进入Stable Diffusion应用详情页,在“资源”列表中找到逻辑名称为“stable_diffusion”的函数资源,单击链接进入函数详情页面。
  2. 在“设置 > 环境变量”页签,单击“编辑环境变量”,在弹出窗口中单击“添加环境变量”,添加下表信息,填写完成后单击“确定”。

    表1 使用API模式访问应用的环境变量

    说明

    EXTRA_ARGS

    --api --api-auth username1:password1,username2:password2 --nowebui

    “username1”和“username2”处填写用户名,“password1”和“password2”处填写需要设置的密码,通过英文逗号(,)分隔多用户的用户名和密码。

  3. 设置完成后,使用API模式访问应用时将需要输入您设置的用户名和密码。

配置并发参数

请参考配置函数的并发处理配置并发参数,WebUI模式和API模式的推荐参数如下:
  • WebUI模式
    • 单实例并发数:>=100。经测试,在单人使用场景下单实例并发量为15左右,如果是多人使用场景推荐将单实例并发数设置为100以上。
    • 单函数最大实例数:1。在WebUI模式下,出图过程中会持续监控任务进度。若存在多个实例,可能引发请求混乱,进而造成进度显示与最终结果呈现的障碍。因此,需将单函数最大实例数设定为1。
  • API模式
    • 单实例并发数:1-5。确保单一实例不会积累过多的待处理请求,当并发量达到上限时,将触发新实例的启动,以保证图像生成的效率。
    • 单函数最大实例数:默认400。可根据实际需要调整。

使用API模式访问应用并启用WebUI认证

如需同时使用API模式访问应用和启用WebUI认证,环境变量内容可参考表2设置。

表2 使用API模式访问应用并启用WebUI认证

说明

EXTRA_ARGS

--api --api-auth user1:password1 --gradio-auth user1:password1

“username1”和“username2”处填写用户名,“password1”和“password2”处填写需要设置的密码,通过英文逗号(,)分隔多用户的用户名和密码。