InvokeAI 如何配置 remote_api_tokens 下载需要 API Key 的模型市场资源【免费下载链接】InvokeAIInvoke is a leading creative engine for Stable Diffusion models, empowering professionals, artists, and enthusiasts to generate and create visual media using the latest AI-driven technologies. The solution offers an industry leading WebUI, and serves as the foundation for multiple commercial products.项目地址: https://gitcode.com/GitHub_Trending/in/InvokeAI通过 InvokeAI 的 Model Manager 用 URL 直接链接安装模型时部分模型市场要求携带 API token 才能下载。官方文档给出了一个具体场景用 URL而不是 repo id安装 Hugging Face 模型时报错时可能需要配置一个 HF API token。本文说明如何在invokeai.yaml中配置remote_api_tokens或用环境变量作为替代路径并核对配置生效的判断方式。开始前需要准备两样东西一个 InvokeAI 根目录root directoryinvokeai.yaml就在该目录下对应模型市场签发的 API token。定位 invokeai.yaml 及其加载顺序InvokeAI 启动时会按以下顺序查找根目录找到后从该目录读取invokeai.yaml--root pathCLI 参数环境变量INVOKEAI_ROOT当前激活虚拟环境所在的目录兜底当前用户主目录下名为invokeai的目录。根目录中除了invokeai.yaml还有一个展示各设置默认值的示例文件invokeai.example.yaml修改配置时可以参照。设置来源按这个顺序生效CLI args → Environment variables →invokeai.yamlsettings → 内置默认值。也就是说如果同一个设置既出现在环境变量里、又写进了配置文件环境变量的值优先。另外可以用--configCLI 参数指向任意位置的配置文件。在 invokeai.yaml 中写 remote_api_tokens在invokeai.yaml的用户设置区加入remote_api_tokens。每个条目是一组url_regextokenurl_regex可以是任意合法正则必要时需要加引号。以下是官方文档中的示例models.com与其中的 token 均为文档演示值不是真实地址remote_api_tokens: # Any URL containing models.com will automatically use your_models_com_token - url_regex: models.com token: your_models_com_token # Any URL matching this contrived regex will use some_other_token - url_regex: ^[a-z]{3}whatever.*\.com$ token: some_other_token实际使用时把url_regex换成目标市场 URL 的特征片段把token换成真实 API token 即可。机制上下载队列在下载模型文件前会把下载地址与这些条目匹配命中的 token 会作为Bearertoken 附加到下载的网络请求上。文档原文“As far as we know, this works for all model marketplaces that require authorization.”匹配逻辑可以直接在 下载服务源码 中确认它按配置顺序对每个url_regex做re.search命中第一个条目就停止。因此配置多个条目时第一个匹配的条目生效更具体的规则应写在前面。两个容易踩的点文档明确提示 Model Marketplace API Keys 这类设置对 YAML 格式敏感“Some settings, like Model Marketplace API Keys, require the YAML to be formatted correctly”列表缩进和引号要写对配置文件在启动时读取修改invokeai.yaml后需要重启 InvokeAI 服务新 token 才会被加载。Hugging Face URL 安装场景官方文档给出的具体建议用 URL而不是 repo id安装 HF 模型出现错误时先创建 Hugging Face API token再在remote_api_tokens下为它添加条目url_regex使用huggingface.coremote_api_tokens: - url_regex: huggingface.co token: 你从 Hugging Face 账户获取的真实 API token上例中 token 值由读者替换为自己的 HF token其余照抄。如果你习惯直接粘贴 HuggingFace Repo ID 安装形如XpucT/DeliberateModel Manager 会自动识别并路由到 HuggingFace 安装流程那是文档支持的另一条安装路径涉及需要鉴权的市场时token 配置方式相同。替代路径环境变量所有设置都可以通过在变量名加INVOKEAI_前缀的环境变量来设置。remote_api_tokens属于非基础类型需要传 JSON 编码的字符串以下modelmarketplace与12345是官方文档的示例值替换为实际的 URL 片段和 tokenexport INVOKEAI_REMOTE_API_TOKENS[{url_regex:modelmarketplace, token: 12345}]文档明确建议优先使用invokeai.yaml因为它更易用。同时记住优先级规则该环境变量一旦存在会覆盖配置文件中的同名设置。验证配置是否生效文档没有提供专门的校验命令可以按以下文档给出的现象核对看下载请求是否带上 token配置生效后下载模型文件的网络请求会携带Bearertoken。这一行为对应 下载服务源码 中“有 token 时添加Authorization: Bearer token请求头”的实现。重放失败场景配置前用 URL而非 repo id安装 HF 模型会报错——这是文档描述的失败现象配置后在 Model Manager 重新执行同一安装下载应能正常完成模型进入 Model Manager 的模型列表并可被生成流程选用。仍报错时排查三处下载地址是否真的与所写的url_regex正则匹配YAML 缩进与引号是否正确是否存在INVOKEAI_REMOTE_API_TOKENS环境变量覆盖了配置文件中的设置。限制说明该设置只把 token 以Bearer形式附加到下载请求上。某个具体市场是否兼容取决于其自身鉴权方式文档的措辞是“As far as we know”据我们所知对需要授权的模型市场均有效。多个条目时只有第一个匹配的url_regex生效源码行为不要把宽泛规则写在具体规则前面。模型安装完成后的管理操作批量删除、重新识别、孤儿模型清理等见 Modelsremote_api_tokens的完整设置说明见 invokeai.yaml 配置文档 的 Model Marketplace API Keys 一节。【免费下载链接】InvokeAIInvoke is a leading creative engine for Stable Diffusion models, empowering professionals, artists, and enthusiasts to generate and create visual media using the latest AI-driven technologies. The solution offers an industry leading WebUI, and serves as the foundation for multiple commercial products.项目地址: https://gitcode.com/GitHub_Trending/in/InvokeAI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考