企业官网建设流程全解析

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 directory），invokeai.yaml就在该目录下；
• 对应模型市场签发的 API token。

定位 invokeai.yaml 及其加载顺序

InvokeAI 启动时会按以下顺序查找根目录，找到后从该目录读取invokeai.yaml：

1. --root <path>CLI 参数；
2. 环境变量INVOKEAI_ROOT；
3. 当前激活虚拟环境所在的目录；
4. 兜底：当前用户主目录下名为invokeai的目录。

根目录中除了invokeai.yaml，还有一个展示各设置默认值的示例文件invokeai.example.yaml，修改配置时可以参照。

设置来源按这个顺序生效：CLI args → Environment variables →invokeai.yamlsettings → 内置默认值。也就是说，如果同一个设置既出现在环境变量里、又写进了配置文件，环境变量的值优先。另外可以用--configCLI 参数指向任意位置的配置文件。

在 invokeai.yaml 中写 remote_api_tokens

在invokeai.yaml的用户设置区加入remote_api_tokens。每个条目是一组url_regex+token，url_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.co：

remote_api_tokens: - url_regex: huggingface.co token: 你从 Hugging Face 账户获取的真实 API token

上例中 token 值由读者替换为自己的 HF token，其余照抄。如果你习惯直接粘贴 HuggingFace Repo ID 安装（形如XpucT/Deliberate，Model Manager 会自动识别并路由到 HuggingFace 安装流程），那是文档支持的另一条安装路径；涉及需要鉴权的市场时，token 配置方式相同。

替代路径：环境变量

所有设置都可以通过在变量名加INVOKEAI_前缀的环境变量来设置。remote_api_tokens属于非基础类型，需要传 JSON 编码的字符串（以下modelmarketplace与12345是官方文档的示例值，替换为实际的 URL 片段和 token）：

export INVOKEAI_REMOTE_API_TOKENS='[{"url_regex":"modelmarketplace", "token": "12345"}]'

文档明确建议优先使用invokeai.yaml，因为它更易用。同时记住优先级规则：该环境变量一旦存在，会覆盖配置文件中的同名设置。

验证配置是否生效

文档没有提供专门的校验命令，可以按以下文档给出的现象核对：

1. 看下载请求是否带上 token：配置生效后，下载模型文件的网络请求会携带Bearertoken。这一行为对应 下载服务源码 中“有 token 时添加Authorization: Bearer <token>请求头”的实现。
2. 重放失败场景：配置前，用 URL（而非 repo id）安装 HF 模型会报错——这是文档描述的失败现象；配置后在 Model Manager 重新执行同一安装，下载应能正常完成，模型进入 Model Manager 的模型列表并可被生成流程选用。
3. 仍报错时排查三处：下载地址是否真的与所写的url_regex正则匹配；YAML 缩进与引号是否正确；是否存在INVOKEAI_REMOTE_API_TOKENS环境变量覆盖了配置文件中的设置。

限制说明

• 该设置只把 token 以Bearer形式附加到下载请求上。某个具体市场是否兼容取决于其自身鉴权方式，文档的措辞是“As far as we know”（据我们所知对需要授权的模型市场均有效）。
• 多个条目时只有第一个匹配的url_regex生效（源码行为），不要把宽泛规则写在具体规则前面。
• 模型安装完成后的管理操作（批量删除、重新识别、孤儿模型清理等）见 Models；remote_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