本指南将引导您从“实时对话式 AI”（旧版）迁移到“AI 音视频互动方案”（新版）。 ## 核心变更 |对比维度 |实时对话式 AI (旧版) |AI 音视频互动方案 (新版) | |---|---|---| |**服务开通** |需分别开通火山 RTC、ASR、TTS、LLM 等多个服务 |只需开通“AI 音视频互动方案”服务 | |**应用管理** |使用实时对话式式 AI 的 AppId |使用“AI 音视频互动方案”的专属 AppId | |**API 调用** |* 接口版本为`2024-12-01`|* 接口版本为`2025-06-01`|\ | |* `StartVoiceChat（2024-12-01）` 接口需为各 AI 服务传入独立凭证 |* `StartVoiceChat（2025-06-01）` 不再需要 AI 服务凭证 | |**计费模式** |多服务独立计费（RTC 时长、ASR 时长、TTS 字符、LLM Tokens） |按 Tokens 计费，简化计费逻辑 | |**功能** |/ |AI 音视频互动方案不支持以下功能：|\ | | ||\ | | |* 接入方舟应用（不再支持） | ## 迁移限制 |若您已使用了以下功能 |建议 | |---|---| |接入方舟应用 |AI 音视频互动方案，不再支持接入方舟应用。建议：|\ | ||\ | |* 改为方舟模型，具体操作参考[步骤 3：重构 OpenAPI 请求体](/docs/6348/2137638#a615ab8f)。|\ | |* 继续使用实时对话式 AI。 | ## **迁移步骤** ### 步骤 1：开通新服务前往 [AI音视频互动方案控制台](https://console.volcengine.com/conversational-ai)，首次进入时按照界面提示完成服务开通。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/bc7458aeb9674315a152c9d31dc769af =549x) ### 步骤 2：调整鉴权逻辑使用 `AI 音视频互动方案` 的应用 ** ** `AppId` **、** `AppKey` 重新为客户端生成 RTC 鉴权 Token。 1. 在 [AI音视频互动方案-应用管理](https://console.volcengine.com/conversational-ai/devTools/appIdManage) 页面，复制目标应用的 `AppId`。**建议先使用默认应用的 AppId**。 :::warning 赠送的 Tokens 仅对 AI 音视频互动方案的系统默认创建应用生效，您后续自行创建的其他应用无法使用此免费额度。**建议先使用默认应用的 AppId**。 ::: 2. 替换旧鉴权代码中的 `AppId` **、** `AppKey` 的值。 ### 步骤 3：重构 OpenAPI 请求体 1. 更新 StartVoiceChat、UpdateVoiceChat、StopVoiceChat 接口以下信息： * `Version` 改为 `2025-06-01`。 * `AppId` 替换为您在步骤 1 中获取的应用 `AppId`。 2. 更新 `StartVoiceChat` 接口。若使用了火山引擎的 ASR、TTS、LLM 服务，需更改接口的 `ASRConfig`、`TTSConfig` 和 `LLMConfig` 配置。 #### **ASRConfig** ```mixin-react return ( ); ``` #### **TTSConfig** ```mixin-react return ( ); ``` #### LLMConfig（仅使用方舟模型 `Mode: "ArkV3"` 时需修改） > `ModelName` 支持的取值，请参见[支持的方舟模型](/docs/6348/1581714#72b35722)。 ```JSON "LLMConfig": { "Mode": "ArkV3", // "EndPointId": "YOUR_ENDPOINT_ID", // 移除此字段 "ModelName": "YOUR_MODEL_NAME", // 新增：必须使用模型名称，例如 "doubao-seed-1-6-251015" "SystemMessages": [ "..." ] } ``` ### 步骤 4：适配新的计费模式迁移后，您的费用将不再按 RTC、ASR、TTS 等服务分别计算，而是统一折算为 Tokens 进行计量。 1. **理解新计费**：请详细阅读[AI 音视频互动方案计费](/docs/6348/2123214)，了解 Tokens 的计费规则。 2. **（建议）** [购买 Token 资源包](https://console.volcengine.com/conversational-ai/purchase)**享受优惠**。 ### 步骤 5：测试与上线完成以上所有步骤后，请使用新的 `AppId`、`Token` 和 `StartVoiceChat` 请求体进行充分测试，确保交互符合预期，然后即可正式上线。如果您在迁移过程中遇到任何问题，请随时联系技术支持。

实时音视频