迁移指南--实时音视频-火山引擎

文档中心

实时音视频

开始使用

迁移指南

本指南将引导您从“实时对话式 AI”（旧版）迁移到“音视频互动智能体”（新版）。

核心变更

对比维度	实时对话式 AI (旧版)	音视频互动智能体 (新版)
服务开通	需分别开通 RTC、ASR、TTS、LLM 等多个服务	只需开通“音视频互动智能体”服务
应用管理	使用实时对话式式 AI 的 AppId	使用“音视频互动智能体”的专属 AppId
API 调用	接口版本为`2024-12-01` `StartVoiceChat（2024-12-01）` 接口需为各 AI 服务传入独立凭证	接口版本为`2025-06-01` `StartVoiceChat（2025-06-01）` 不再需要 AI 服务凭证
计费模式	多服务独立计费（RTC 时长、ASR 时长、TTS 字符、LLM Tokens）	统一 Tokens 计费，所有核心服务消耗折算为 Tokens
功能		音视频互动智能体不支持以下功能：接入方舟应用（不再支持）豆包端到端实时语音大模型（暂不支持）

迁移限制

若您使用了以下功能	建议
接入方舟应用	音视频互动智能体，不再支持接入方舟应用。建议：改为方舟模型，具体操作参考步骤 3：重构 OpenAPI 请求体。继续使用实时对话式 AI。
豆包端到端实时语音大模型	暂不支持该功能。建议：改用 ASR+TTS+LLM 方案，可通过控制台快速获取请求体。具体操作参考附录：快速生成 StartVoiceChat 请求示例。继续使用实时对话式 AI。

若您使用了以下功能

建议

接入方舟应用

音视频互动智能体，不再支持接入方舟应用。建议：

改为方舟模型，具体操作参考步骤 3：重构 OpenAPI 请求体。
继续使用实时对话式 AI。

豆包端到端实时语音大模型

暂不支持该功能。建议：

改用 ASR+TTS+LLM 方案，可通过控制台快速获取请求体。具体操作参考附录：快速生成 StartVoiceChat 请求示例。
继续使用实时对话式 AI。

迁移步骤

步骤 1：开通音视频互动智能体服务

前往音视频互动智能体控制台，首次进入时按照界面提示完成服务开通。

使用默认应用：服务开通后，系统会自动创建一个默认应用，并为该应用赠送一定额度的 Tokens 免费资源包。
注意
赠送的 Tokens 仅对首次开通服务时创建的默认应用生效，您后续自行创建的其他应用将无法使用此免费额度。为充分利用免费额度，建议您在迁移和测试阶段直接使用这个默认应用。
在应用管理页面，复制目标应用的 AppId。

步骤 2：调整鉴权逻辑

使用音视频互动智能体的应用对应的 **** AppId、AppKey 重新为客户端生成 RTC 鉴权 Token。

在应用管理页面，复制目标应用的 AppId。建议先使用默认应用的 AppId。
注意
赠送的 Tokens 仅对音视频互动智能体的系统默认创建应用生效，您后续自行创建的其他应用无法使用此免费额度。建议先使用默认应用的 AppId。
替换旧鉴权代码中的 AppId、AppKey 的值。

步骤 3：重构 OpenAPI 请求体

更新 StartVoiceChat、UpdateVoiceChat、StopVoiceChat 接口以下信息：
- Version 改为 2025-06-01。
- AppId 替换为您在步骤 1 中获取的“音视频互动智能体”的应用 AppId。

更新 StartVoiceChat 接口。
若使用了火山引擎的 ASR、TTS、LLM 服务，需更改接口的 ASRConfig、TTSConfig 和 LLMConfig 配置。

ASRConfig

return (<Tabs>
      <Tabs.TabPane title="流式语音识别大模型（Mode: "bigmodel"）" key="eTlMEICBfA"><RenderMd content={`* 参数直传：
         \`\`\`JSON
         "ASRConfig": {
             "Provider": "volcano",
             "ProviderParams": {
                 "Mode": "bigmodel",
                 // "AppId": "YOUR_OLD_ASR_APPID",      // 移除此字段
                 // "AccessToken": "YOUR_OLD_ASR_TOKEN", // 移除此字段
                 "ApiResourceId": "volc.bigasr.sauc.duration" // 注意：新版不再支持并发版(...concurrent)，请确保使用小时版
             }
         }
         \`\`\`
      
      * 参数直传：
         \`\`\`JSON
         "ASRConfig": {
             "Provider": "volcano",
             "ProviderParams": {
                 "Mode": "bigmodel",
                 "Credential": {
                     // "AppId": "YOUR_OLD_ASR_APPID",      // 移除此字段
                     // "AccessToken": "YOUR_OLD_ASR_TOKEN", // 移除此字段
                     "ApiResourceId": "volc.seedasr.sauc.duration" // 注意：新版不再支持并发版(...concurrent)，请确保使用小时版
                 },
                 "VolcanoASRParameters": "{}"
             }
         }
         \`\`\`
      
      `}></RenderMd></Tabs.TabPane>
      <Tabs.TabPane title="流式语音识别（Mode: "smallmodel"）" key="rBKQL6YkbF"><RenderMd content={`\`\`\`JSON
      "ASRConfig": {
          "Provider": "volcano",
          "ProviderParams": {
              "Mode": "smallmodel",
              // "AppId": "YOUR_OLD_ASR_APPID", // 移除此字段
              "Cluster": "volcengine_streaming_common"
          }
      }
      \`\`\`
      
      `}></RenderMd></Tabs.TabPane></Tabs>);

TTSConfig

火山语音合成大模型

火山声音复刻大模型

火山语音合成模型

参数直传
JSON "TTSConfig": { "Provider": "volcano_bidirection", "ProviderParams": { // "app": { ... }, // 移除整个 app 鉴权对象 "audio": { "voice_type": "..." }, "ResourceId": "seed-tts-2.0" // 注意：新版不再支持并发版(...concurr)，请确保使用字符版 } }

* 参数透传
   ```JSON
   "TTSConfig": {
       "Provider": "volcano_bidirection",
       "ProviderParams": {
           "Credential": {
               // "AppId": "YOUR_OLD_TTS_APPID", // 移除此字段
               // "Token": "YOUR_OLD_TTS_TOKEN", // 移除此字段
               "ResourceId": "seed-tts-1.0" // 注意：新版不再支持并发版(...concurr)，请确保使用字符版
           },
           "VolcanoTTSParameters": "{...}"
       }
   }
   ```

先购买音色资源、训练并复刻声音，并获声音 ID。具体操作，请参见声音复刻。
2. 修改 TTSConfig 对象。
* 流式输入流式输出-参数直传
JSON "TTSConfig": { "Provider": "volcano_bidirection", "ProviderParams": { // "app": { ... }, // 移除整个 app 鉴权对象 "audio": { "voice_type": "..." }, // voice_type 改为步骤 1 获取的声音 ID。 "ResourceId": "seed-tts-2.0" // 注意：新版不再支持并发版(...concurr)，请确保使用字符版 } }

* 流式输入流式输出-参数透传
  ```JSON
  "TTSConfig": {
      "Provider": "volcano_bidirection",
      "ProviderParams": {
          "Credential": {
              // "AppId": "YOUR_OLD_TTS_APPID", // 移除此字段
              // "Token": "YOUR_OLD_TTS_TOKEN", // 移除此字段
              "ResourceId": "seed-tts-1.0" // 注意：新版不再支持并发版(...concurr)，请确保使用字符版
          },
          "VolcanoTTSParameters": "{"req_params":{"speaker":"S_The****K1s"}}"  // speaker 取值改为步骤 1 获取的声音 ID
      }
  }
  ```

  * 非流式输入非流式输出
  ```JSON
  {
    "TTSConfig": {
      "Provider": "volcano", // 必填：固定值
      "ProviderParams": {
       "app": {                   
          // "appid": "94****11", // 移除
          "cluster": "volcano_icl"
       },
        "audio": {
          "voice_type": "S_N****T7k1", // 取值改为步骤 1 获取的声音 ID
          "speed_ratio": 1.0 // 选填：语速
        }
      }
    }
  }
  ```

"TTSConfig": {
          "Provider": "volcano",
          "ProviderParams": {
              "app": {
                  // "appid": "YOUR_OLD_TTS_APPID", // 移除此字段
                  "cluster": "volcano_tts"
              },
              "audio": { "voice_type": "BV001_streaming" }
          }
      }
      ```

LLMConfig（仅使用方舟模型 Mode: "ArkV3" 时需修改）

ModelName 支持的取值，请参见支持的方舟模型。

"LLMConfig": {
    "Mode": "ArkV3",
    // "EndPointId": "YOUR_ENDPOINT_ID", // 移除此字段
    "ModelName": "YOUR_MODEL_NAME", // 新增：必须使用模型名称，例如 "doubao-seed-1-8-251215"
    "SystemMessages": [ "..." ]
}

步骤 4：适配新的计费模式

迁移后，您的费用将不再按 RTC、ASR、TTS 等服务分别计算，而是统一折算为 Tokens 进行计量。

理解新计费：请详细阅读音视频互动智能体计费，了解 Tokens 的计费规则。
（建议）购买 Token 资源包享受优惠。

步骤 5：测试与上线

完成以上所有步骤后，请使用新的 AppId、Token 和 StartVoiceChat 请求体进行充分测试，确保智能体交互符合预期，然后即可正式上线。
如果您在迁移过程中遇到任何问题，请随时联系技术支持。

最近更新时间：2025.12.26 00:14:44

这个页面对您有帮助吗？

有用

无用