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

文档中心

实时音视频

开始使用

迁移指南

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

核心变更

对比维度	实时对话式 AI (旧版)	AI 音视频互动方案 (新版)
服务开通	需分别开通火山 RTC、ASR、TTS、LLM 等多个服务	只需开通“AI 音视频互动方案”服务
应用管理	使用实时对话式式 AI 的 AppId	使用“AI 音视频互动方案”的专属 AppId
API 调用	接口版本为`2024-12-01` `StartVoiceChat（2024-12-01）` 接口需为各 AI 服务传入独立凭证	接口版本为`2025-06-01` `StartVoiceChat（2025-06-01）` 不再需要 AI 服务凭证
计费模式	多服务独立计费（RTC 时长、ASR 时长、TTS 字符、LLM Tokens）	按 Tokens 计费，简化计费逻辑
功能	/	AI 音视频互动方案不支持以下功能：接入方舟应用（不再支持）豆包端到端实时语音大模型（暂不支持）接入火山 Viking 记忆库（暂不支持）

迁移限制

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

若您已使用了以下功能

建议

接入方舟应用

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

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

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

暂不支持该功能。建议：

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

接入火山 Viking 记忆库

暂不支持该功能。建议：继续使用实时对话式 AI。

迁移步骤

步骤 1：开通新服务

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

步骤 2：调整鉴权逻辑

使用 AI 音视频互动方案 的应用 **** AppId、AppKey 重新为客户端生成 RTC 鉴权 Token。

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

步骤 3：重构 OpenAPI 请求体

更新 StartVoiceChat、UpdateVoiceChat、StopVoiceChat 接口以下信息：
- Version 改为 2025-06-01。
- AppId 替换为您在步骤 1 中获取的应用 AppId。

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

ASRConfig

流式语音识别大模型

流式语音识别

参数直传：

"ASRConfig": {
    "Provider": "volcano",
    "ProviderParams": {
        "Mode": "bigmodel",
        // "AppId": "YOUR_OLD_ASR_APPID",      // 移除此字段
        // "AccessToken": "YOUR_OLD_ASR_TOKEN", // 移除此字段
        "ApiResourceId": "volc.bigasr.sauc.duration" // 注意：新版不再支持并发版(...concurrent)，请确保使用小时版
    }
}

参数透传：

"ASRConfig": {
    "Provider": "volcano",
    "ProviderParams": {
        "Mode": "bigmodel",
        "Credential": {
            // "AppId": "YOUR_OLD_ASR_APPID",      // 移除此字段
            // "AccessToken": "YOUR_OLD_ASR_TOKEN", // 移除此字段
            "ApiResourceId": "volc.seedasr.sauc.duration" // 注意：新版不再支持并发版(...concurrent)，请确保使用小时版
        },
        "VolcanoASRParameters": "{}"
    }
}

"ASRConfig": {
       "Provider": "volcano",
       "ProviderParams": {
           "Mode": "smallmodel",
           // "AppId": "YOUR_OLD_ASR_APPID", // 移除此字段
           "Cluster": "volcengine_streaming_common"
       }
   }

TTSConfig

火山语音合成大模型

火山声音复刻大模型

火山语音合成模型

参数直传：

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

参数透传：

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

先购买音色资源、训练并复刻声音，并获声音 ID。具体操作，请参见声音复刻。再修改 TTSConfig 对象：

流式输入流式输出-参数直传

"TTSConfig": {
    "Provider": "volcano_bidirection",
    "ProviderParams": {
        // "app": { ... }, // 移除整个 app 鉴权对象
        "audio": { "voice_type": "..." },   // voice_type 改为步骤 1 获取的声音 ID。
        "ResourceId": "seed-tts-2.0" // 注意：新版不再支持并发版(...concurr)，请确保使用字符版
    }
}

流式输入流式输出-参数透传

"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
    }
}

非流式输入非流式输出

{
  "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-6-251015"
    "SystemMessages": [ "..." ]
}

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

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

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

步骤 5：测试与上线

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

最近更新时间：2026.01.09 10:56:37

这个页面对您有帮助吗？

有用

无用

实时音视频

核心变更 #

迁移限制 #

迁移步骤 #

步骤 1：开通新服务 #

步骤 2：调整鉴权逻辑 #

步骤 3：重构 OpenAPI 请求体 #