# 接入 AI 对话和文字转语音

> 给作品加入对话、问答或朗读，需要同时完成代码接入和能力配置。只有界面，没有真实调用，功能不会自动生效。

## 先区分“用 AI 改网页”和“网页调用 AI”

编辑器里的 AI 生成、修改，是帮你编写网页；作品高级能力里的 AI，是访客打开网页后发起对话或生成回答。两者的使用入口和费用不同。

文字转语音则把文本变成可播放音频，需要页面实现播放操作，并处理生成失败和浏览器播放限制。

## 按当前指南接入

1. 打开原作品编辑页，进入高级能力管理，检查 AI 或文字转语音是否开启。
2. 补充该作品的高级能力余额，或了解费用后开启自动补充，并检查可设置的每日消耗限制。
3. 打开能力接入指南，按需选择“AI 能力”或“文字转语音”，复制当前生成的提示词和示例。
4. 告诉 AI 作品用途，例如“只回答展馆介绍相关问题”或“点击朗读当前文章”，再附上现有代码。
5. 更新原作品，用正式发布链接点击测试，检查实际回答、音频播放和消耗记录。

## 账户有积分，为什么仍提示余额不足

网站“HTML 转链接”创建页面时，检测到 AI、媒体上传或文字转语音，会默认勾选“自动补充高级能力额度”。发布前可以取消；开启后按访客实际消耗从作者账户积分补充，不在发布时预扣额度。旧作品请到高级能力管理核对，账户积分不足或达到限额时仍可能无法使用。

AI、媒体上传和文字转语音共用**每个作品自己的高级能力余额**。账户积分可按 1:1 转入该作品；没有手动分配、也未开启自动补充时，账户有积分仍可能无法调用。

开启自动补充后，按使用规则从账户补充；账户不足、能力暂停或达到消耗限制时仍会失败。当前模型、音色、价格和限制请以管理面板为准。

## 把这些要求一起告诉 AI

- 使用平台提供的 SDK，不把外部服务密钥写进 HTML，不让访客填写你的密钥。
- 只在用户点击或提交后调用，等待时防止重复提交，不自动轮询、重试或反复生成。
- 显示加载、失败与手动重试；流式回答中断或被截断时，不提示“完整生成成功”。
- 聊天记录若要跨设备保存，另行选择合适的数据方案。接入 AI 不会自动保存聊天历史。

## 没有回答或没有声音时

先核对能力开关、作品余额与每日限制，再查看页面显示的错误。模型或音色参数应来自当前指南，不要猜名称。音频已生成但不能播放时，尝试由用户点击播放，并检查设备音量。

确认使用的是更新后的正式链接；本地 HTML 或编辑器预览不一定具有发布后的 SDK 环境。保存问题可继续看 [云端数据指南](https://html2.link/guide/cloud-data)。
