安装指南 — AkaVoice

分步指南

点击本页顶部的下载按钮。你会得到一个名为 podcastbot-latest.zip 的文件。不要解压 — WordPress 需要原样的 ZIP。

登录你的 WordPress 后台，前往插件 → 安装插件 → 上传插件。选择你刚下载的 ZIP 文件，点击 现在安装。

安装后，点击 启用插件。AkaVoice 会带着自己的菜单图标出现在你的侧边栏。

前往 platform.openai.com/api-keys，点击 Create new secret key，然后复制它。不要关闭标签页 — OpenAI 只会显示密钥一次。

初次使用 OpenAI？在 Billing 中仅充值 5 美元 — 足够做约 50 个播客。

在 Spreaker 中：Account → Developer → API Token。复制 token。然后进入你的节目，从 URL 中复制数字 Show ID。

打开 AkaVoice → Settings。粘贴 OpenAI 密钥、Spreaker 密钥和 Show ID。选择一种语音（英语推荐 Nova，意大利语推荐 Isabella）。保存。

前往 AkaVoice → Queue。选择一篇文章，点击 Convert now。约 60 秒后，你会在文章顶部看到嵌入式播放器。24 小时内，它会在 Spotify 上线。

故障排除

上传时出现 "The package could not be installed" 错误

你的主机限制了 ZIP 上传大小。两个办法：(1) 在 php.ini 中把 upload_max_filesize 提高到 32M；(2) 通过 FTP 上传 — 在本地解压，把 akavoice 文件夹复制到 /wp-content/plugins/，然后在 WP 后台启用。

保存设置时出现 "Invalid API key"

常见原因：密钥开头/结尾多了空格、密钥在 OpenAI 后台被吊销，或 OpenAI 账号余额为零。仔细重新复制，并确认 OpenAI 的 Billing 显示有可用额度。

转换卡在 "Processing" 状态

cron 每 4 分钟运行一次 — 请至少等待 5 分钟。如果仍然卡住：AkaVoice → Logs，查找最新的错误。最常见的是 Spreaker Show ID 拼写错误，或 TTS API 的速率限制。

音频播放器没有出现在文章上

检查 AkaVoice → Settings → Display — 必须启用自动嵌入。某些缓存插件（WP Rocket、W3 Total Cache）在生成第一个播客后需要手动清除缓存。

我的播客还没有出现在 Spotify 上

Spotify 会在 24 小时内收录 Spreaker 节目。第一次，节目审核可能需要最多 5 天。请在 Spreaker 后台查看剧集状态。