易写作接入 OpenAI 兼容接口的配置方法

把易写作的 AI 功能切到 OpenAI 兼容接口，关键是确认两件事：一是在易写作里能找到接口配置的位置，二是你手里的服务地址能被正确调用。先按通用方式完成参数填写，再用 curl 验证接口，能快速定位是地址问题还是密钥问题。

这里的判断是：只要易写作提供 AI 服务配置项，且你的中转服务使用 OpenAI 协议，就可以接入。操作动作是填写 base_url、api_key、model，设置时注意路径前缀；验证方式是用 curl 请求 /v1/chat/completions；风险边界是不同版本易写作的字段名可能不同，需要结合当前环境确认，且本文不覆盖私有化鉴权方式。

找到易写作的 AI 服务配置入口

易写作的配置入口一般有两处：网页版在设置页面，桌面版或本地部署版在安装目录的 .env 文件里。先打开设置页面，查找名称含“服务”“接口”“模型”的区域，例如“AI 服务”“模型服务”“接口地址”。如果页面里没有这些项，回到安装目录，找到一个名为 .env 的文件，用文本编辑器打开，搜索 BASE_URL、API_KEY、MODEL 等关键词。

这里需要区分：如果你用的是网页版，配置通常在管理员或用户设置里；如果是自己部署的，配置写入 .env 后需要重启服务才能生效。查看时不要只截断字段名，要保留原有注释和格式，方便回退。

按 OpenAI 兼容格式填写接地址和密钥

填写前先确认你的服务商要求的格式。OpenAI 兼容接口通常提供 base_url、api_key、model 三个参数。以下是一个可替换的示例：

BASE_URL=https://api.example.com/v1
API_KEY=sk-此处替换为你的密钥
MODEL=gpt-3.5-turbo

base_url 的填写最容易出错。如果服务商给出的是 https://api.example.com，没有带 /v1，那么你需要手动补上 /v1，因为兼容接口的补全请求路径是 /v1/chat/completions。如果服务商给了 https://api.example.com/v1，那就不要再额外加 /v1。地址末尾不要带斜杠，否则某些客户端拼接时会产生双斜杠。

api_key 要完整复制，不能有换行或空格。model 名称必须和服务端部署的模型名完全一致，不同服务商对同一模型的命名可能并不相同，例如有些服务商使用“gpt-3.5-turbo”，有些使用“gpt-35-turbo”。如果填错，会在请求时收到 model_not_found 错误。

先用 curl 验证接口是否可通

在易写作里测试前，先跳过易写作这个客户端，直接用 curl 打接口，能排除网络、证书、代理等问题。把下面命令中的地址、密钥和模型名替换成你的：

curl -X POST https://api.example.com/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-此处替换为你的密钥" -d '{"model":"gpt-3.5-turbo","messages":[{"role":"user","content":"你好"}]}'

如果接口通畅，返回的 JSON 会包含 choices 字段，例如：

{"choices":[{"message":{"role":"assistant","content":"你好"}}]}

如果返回 error 字段，例如 {"error":{"message":"Incorrect API key","type":"invalid_request_error"}}，说明密钥或地址有问题。这种验证方式能直接告诉你问题是否出在基础连接层。

在易写作中触发一次生成测试

确认 curl 通畅后，回到易写作。新建一篇笔记或文案，在编辑区输入一段文字，调用 AI 润色、续写或生成功能。页面如果正常返回内容，说明配置生效。如果还是失败，需要看易写作的日志记录。

日志文件一般在安装目录的 logs 文件夹下，文件名类似 app.log 或 server.log。打开日志，搜索本次调用时间对应的记录，找 error、status、unauthorized 等关键词。如果日志里显示 401，说明密钥问题；显示 404，说明地址路径问题；显示超时，则先看网络连接。根据日志中的具体错误码，回到下一节的排查对照。

排查 401、404、超时三类常见错误

401 Unauthorized：通常是对应 API Key 错误或已失效。检查易写作 .env 或设置里保存的 api_key 是否和 curl 命令用的一致，确认没有多余换行。如果服务商使用 OAuth 等其他鉴权方式，易写作不一定支持，需要换一个兼容 OpenAI Bearer 鉴权的服务。
404 Not Found：通常是 base_url 路径不正确。确认地址是否拼接成 /v1/chat/completions。如果服务商要求把模型名放在 URL 中，例如 /v1/models/{model}，而你只配置了根地址，也会造成 404。需要核对服务商文档，但本文不虚构具体路径，你可以在服务商提供的测试页面里查看实际的请求地址。
超时：可能的原因包括网络不可达、防火墙拦截、服务端响应慢。先用 curl 加 `--max-time` 10 测试同一地址，如果 curl 超时，说明问题不在易写作；如果 curl 能通，但易写作超时，可以尝试在配置中调大请求超时时间，或者检查系统代理设置，易写作可能代理设置不生效。

这些排查步骤不限于易写作，其他使用 OpenAI 兼容接口的工具也适用。核心是先通过 curl 确定接口本身可用，再观察易写作的日志，对比错误码，就能把问题定位到“密钥、路径、网络”三个方向之一。

易写作 接入 OpenAI 兼容接口的配置方法