API Key 配置手册

涵莺公众号文章生成器需要配置文案生成 API。生成封面和配图时，还需要单独配置图片生成 API。

API Key 是你在第三方大模型平台创建的调用凭证，相当于这套工具调用 AI 的钥匙。请只粘贴到生成器配置页，不要发到群里，也不要截图外泄。

1. 进入配置页

1. 登录涵莺公众号文章生成器。
2. 点击顶部「配置」。
3. 找到「API 配置」区域。
4. 第一次配置前，先点击「查看 API Key 配置手册」。
5. 按手册准备好文案 API Key 和图片 API Key。
6. 回到配置页，点击「修改 API 配置」后填写信息。

新手按默认参数填写即可，不建议自行修改默认模型参数。

2. 先获取 API Key

先到对应 AI 平台创建 API Key 并充值，再回到生成器填写。

2.1 通用流程

1. 打开对应 AI 平台官网。
2. 用手机号注册或登录。
3. 按平台要求完成实名认证。
4. 进入「控制台」「个人中心」或「开发者平台」。
5. 找到「API Key」「API 密钥」或「密钥管理」。
6. 点击「创建 API Key」「新建密钥」或类似按钮。
7. 给密钥起一个容易识别的名字，例如「涵莺公众号文章生成器」。
8. 创建后立刻复制 API Key，并保存在密码管理器或自己可控的安全位置。
9. 到「充值」「余额」或「费用中心」充值小额金额，建议先用 10 元左右测试。

API Key 通常只完整显示一次。找不到时，建议重新创建一个新的 Key，并删除不再使用的旧 Key。

2.2 智谱 API Key 获取方法

智谱适合用作文案生成 API。按下面步骤操作：

1. 打开智谱官网：https://open.bigmodel.cn/。
2. 登录账号，并按平台要求完成实名认证。
3. 在官网右上角点击「控制台」。
4. 进入控制台后，在左侧菜单点击「API Key」。
5. 点击「新建 API Key」。
6. API Key 名称可以随便起，建议写成「涵莺公众号文章生成器」，方便以后识别。
7. 创建后点击复制按钮。
8. 回到涵莺公众号文章生成器，在「配置」页把它粘贴到「文案 API Key」里。
9. 文案生成 API 选择「智谱」，文案模型可填 glm-5.1。
10. 智谱接口地址保持默认 https://open.bigmodel.cn/api/paas/v4，新手不要手动修改。

2.3 DeepSeek API Key 获取方法

DeepSeek 适合用作文案生成 API。按下面步骤操作：

1. 打开 DeepSeek 官网。
2. 点击「API 开放平台」。
3. 登录账号后，进入开放平台后台。
4. 在左侧菜单点击「API keys」。
5. 点击「创建 API key」。
6. 名称可以随便起，建议写成「涵莺公众号文章生成器」。
7. 创建后立刻点击「复制」。
8. 回到涵莺公众号文章生成器，在「配置」页把它粘贴到「文案 API Key」里。
9. 文案生成 API 选择「DeepSeek」，模型按手册或平台当前推荐模型填写。

DeepSeek 主要用于文案生成。封面和配图仍然需要另外配置图片 API Key。

2.4 豆包/火山方舟图片 API Key 获取方法

豆包/火山方舟适合用作图片生成 API。按下面步骤操作：

1. 打开火山引擎官网。
2. 登录账号，并按平台要求完成实名认证。
3. 在顶部菜单点击「大模型」。
4. 进入大模型页面后，找到「豆包图像创作模型 5.0」。
5. 点击进入模型详情页。
6. 点击右上角「API 接入」。
7. 在「快捷 API 接入」弹窗里，展开「获取 API KEY」。
8. 如果还没有 Key，点击「创建 API Key」。
9. 名称可以随便起，建议写成「涵莺公众号文章生成器」。
10. 点击「创建并使用」。
11. 回到「获取 API KEY」列表，点击小眼睛显示 Key。
12. 复制后，回到涵莺公众号文章生成器，在「配置」页把它粘贴到「图片 API Key」里。
13. 图片生成 API 选择「豆包」，图片模型建议填 doubao-seedream-5-0-260128。

图片 API Key 必须单独填写。文案 API Key 不会自动复用为图片 API Key。

2.5 其他兼容接口

如果你使用其他支持通用对话接口格式的平台，文案生成 API 选择「其他模型」，填写平台提供的完整接口地址、模型名和 API Key。

如果你使用其他兼容图片生成接口的平台，图片生成 API 选择「其他图片生成模型」，填写平台提供的完整接口地址、模型名和 API Key。

3. 配置文案生成 API

文案 API 用来生成爆文正文。填写时重点确认四项：服务商、模型名、计费模式、文案 API Key。

DeepSeek 旧模型名 deepseek-chat、deepseek-reasoner 已不建议新配置使用。选择「其他模型」时，请确认平台接口兼容通用对话接口格式，并填写完整接口地址。

4. 配置图片生成 API

图片 API 用来生成爆文封面和配图。填写时重点确认三项：图片服务商、图片模型、图片 API Key。

• 豆包：选择「豆包」，模型建议填 doubao-seedream-5-0-260128。
• 其他兼容接口：选择「其他图片生成模型」，填写平台提供的接口地址、模型名和 API Key。

豆包图片生成使用火山方舟图片接口，当前推荐模型为 doubao-seedream-5-0-260128。旧模型如 doubao-seedream-3-0-t2i 不建议新配置使用。

文案 API Key 和图片 API Key 是两栏。请把文案大模型的专用 Key 粘贴到「文案 API Key」，把图片大模型的专用 Key 粘贴到「图片 API Key」，不要互相填错。

5. 保存并确认

1. 填写完成后点击「保存 API 配置」。
2. 保存成功后，配置页会显示已保存的服务商、模型和掩码后的 Key。
3. 回到「生成」页，先用 1 个标题测试生成。

API Key 只会显示掩码，不会在页面明文展示。重新填写 Key 后保存，才会覆盖原配置。

6. 生成后如何判断图片 API 是否正常

文案生成成功但封面或配图显示为默认本地占位图时，通常说明图片 API 没有跑通，不是文案 API 的问题。

1. 图片 API Key 是否已经单独填写并保存。
2. 图片模型名称是否和第三方平台一致。
3. 图片 API 地址是否被手动改错。系统自动填入的地址一般不要改。
4. 图片平台是否已经开通对应模型。
5. 图片平台账号是否有余额或额度。
6. 修改后重新点击「保存 API 配置」，再用 1 个标题测试生成。

如果截图发到群里，请把 API Key、手机号、订单号等敏感信息打码。

7. 常见问题

不知道自己该选哪个文案模型怎么办？

优先选择自己已经开通并充值的平台。如果不确定智谱计费模式，一般先选择「API Key 按量付费」。

图片 API Key 可以不填吗？

不可以。生成封面和配图需要图片 API Key；即使文案 API 已配置，也需要单独填写图片 API Key。

API Key 创建后找不到了怎么办？

多数平台只在创建时完整显示一次。找不到时，建议重新创建一个新的 API Key，并删除不再使用的旧 Key。

保存后生成失败怎么办？

先检查 API Key 是否复制完整，再检查模型名是否和平台后台一致。仍失败时，换 1 个简单标题单篇测试，确认是哪一项配置报错。

保存按钮在哪里？

配置页底部有「修改 API 配置」或「保存 API 配置」按钮。填完文案 API Key 和图片 API Key 后，一定要点击保存。只粘贴不保存，系统不会使用新 Key。