Craft AI 配置教程：用自定义 API 接入大模型
Craft 的 AI 功能不是打开就能用，需要先在设置里绑定一个可用的模型服务。
如果你手上已有 OpenAI 兼容接口的密钥，或者想接本地 Ollama，这篇 Craft AI 配置教程按顺序走一遍即可，新手也能对照完成。
先确认你手里有什么
配置前先准备两样东西：一是模型服务的 API Key，二是该服务的 Base URL 和模型名称。
Craft 支持接入兼容 OpenAI 接口的服务，常见选择包括官方 OpenAI、Azure OpenAI 以及自建代理；
本地运行 Ollama 也可以，但需要把地址指向本机服务。
打开 Craft 后，进入 Settings（设置）面板，找到 AI 或 Integrations 分类。
不同客户端版本菜单名称略有差异，以你当前界面显示为准。
这里需要添加一个自定义 AI 提供方，而不是登录 Craft 账号就自动完成。
填写连接参数
在 AI 设置页选择添加自定义提供方，然后逐项填写：
Provider：选择 OpenAI 兼容或 Custom。API Key：粘贴你的密钥，注意前后不要带空格。Base URL：官方接口通常是https://api.openai.com/v1；使用代理或自建服务时改成对应地址，末尾一般保留/v1。Model：填写服务商实际提供的模型名，例如gpt-4o-mini或你本地已拉取的模型名。
填完后保存，Craft 会尝试发起一次连接检查。
如果界面没有自动检查，就新建一个文档，在正文里输入一段提示词，观察是否返回结果。
这一步是判断配置是否生效最直接的方式。
容易踩坑的几个地方
Base URL 多写或少写路径是最常见的失败原因。
很多兼容服务要求地址精确到 /v1，写成根域名会返回 404。
保存前把地址复制到浏览器里访问一下，确认能返回接口信息再填。
模型名和密钥不匹配也会导致调用失败。
如果你用的是代理服务，模型名必须和代理后台列出的名称一致，不能直接照搬官方文档里的示例。
另外，本地 Ollama 默认只监听 127.0.0.1，Craft 如果运行在另一台设备上会连不上。
这种情况需要让 Ollama 对外监听，并在防火墙放行对应端口，同时注意不要把这个端口暴露到公网。
验证与回退
配置保存后，用一条短提示测试，例如让 Craft 总结当前文档的一段文字。
能正常返回内容，说明密钥、地址和模型名三者已经对齐。
如果报错，优先检查密钥是否过期、账户是否有余额、Base URL 是否可达。
需要回退时，回到 AI 设置页删除自定义提供方即可，不会影响已有文档内容。
建议在修改前记录原来的配置项，方便恢复。
常见疑问
Craft 自带 AI 吗？ 部分版本提供内置 AI 入口，但自定义模型仍需手动配置，不能仅靠登录账号直接调用。
可以接多个模型吗？ 可以在设置中保留多个提供方，按使用场景切换，但每个提供方都要单独填写密钥和地址。
配置后没有反应怎么办？ 先确认当前文档是否处于可编辑状态，再检查网络是否能访问 Base URL；
本地模型还要确认服务进程正在运行。
按上面的顺序操作，Craft AI 配置的核心就是三件事：选对提供方、填准地址和模型名、用一条测试提示验证。
遇到连接失败时，从 Base URL 和密钥两项开始排查，通常能快速定位问题。
