跳到主要内容

modelAPI / modelDir 怎么填

WordPress 后台 → Live2D 设置 → 「创意工坊 API 类型」选 自定义 后会出现两个输入：

  • modelAPI — 一个 URL 或 URL 前缀
  • modelDir — 一个列表，每行一个子目录名

它们的组合方式由 modelAPI 的结尾字符决定，只有两种填法。

填法 ①：直链单模型（modelAPI 以 .json 结尾）​

modelAPI 直接填一个完整的 *.model3.json URL，下方 modelDir 列表会被忽略。

示例

modelAPI:  https://cdn.example.com/live2d/haru/haru.model3.json
modelDir:  （留空，会被忽略）

加载时浏览器直接请求这个 JSON。前台的"上一个 / 下一个"切换按钮在这种模式下没有意义，建议在后台关闭。

填法 ②：目录根 + 多模型（modelAPI 以 / 结尾）​

modelAPI 是一个根目录 URL，modelDir 列出多个子目录名。插件按 {modelAPI}{名称}/{名称}.model3.json 自动拼接成完整 URL。

关键约束：每个子目录里的 *.model3.json 文件名必须与子目录名完全一致。

示例

modelAPI:  https://cdn.example.com/live2d/

modelDir:
  - haru
  - mao
  - shizuku

实际加载时插件会拼成：

https://cdn.example.com/live2d/haru/haru.model3.json
https://cdn.example.com/live2d/mao/mao.model3.json
https://cdn.example.com/live2d/shizuku/shizuku.model3.json

前台的"眨眼按钮 / 切换按钮"会在这几个模型之间循环。

选哪一种？​

场景推荐填法
只挂一个固定模型，不打算切换① 直链
想让访客能在多个模型之间切换② 目录根 + 多个 modelDir
想用「托管到本站」托管模型② —— 此时 modelAPI 输入框被隐藏，只填 modelDir

路径 / 协议要求​

  • 路径里不能有中文。
  • 站点是 https，那么 modelAPI 以及它引用到的所有文件（.moc3、贴图、motion3.json、physics3.json、cdi3.json 等）都必须是 https，否则浏览器会因为混合内容报错。
  • 跨域：把模型放到 OSS / COS / 自家 CDN 时，请正确开启 CORS（一般加上你的站点域名作为允许的 Origin 即可）。

浏览器扩展端有什么不同？​

浏览器扩展的"自定义 URL（付费）"模式 modelAPI / modelDir 填法与 WordPress 插件完全一致，只是没有「托管到本站」选项。请确保你的源 URL 允许 chrome-extension://... 或 * 作为 Origin。