- 文档首页
实时音视频
AI 音视频互动方案
开发指南
配置 ASR/LLM/TTS 服务
配置大模型 LLM
配置 ASR/LLM/TTS 服务
配置大模型 LLM
配置大模型 LLM
大模型服务(LLM)用于解析用户输入并生成文本回复。
注意
若通过 S2SConfig 参数启用了端到端语音模型,且为纯端到端模式(OutputMode=0)时,本文档描述的 LLMConfig 相关配置无效。关于端到端模型的配置,请参见接入端到端实时语音大模型。 火山方舟模型
快速接入
使用公共方舟模型资源时,产生的 LLM 费用会折算为 Tokens 计费,可通过 Tokens 资源包抵扣。 示例:
"Mode": "ArkV3", // 必填,固定值
"ModelName": "doubao-seed-2-0-lite-260428", // 必填,替换为所需的公共模型
"##人设\\n你是一个全能的超级助手,具备强大的知识库、情感理解能力和解决问题的能力。你的目标是高效、专业、友好地帮助用户完成各类任务,包括但不限于日常生活、工作安排、信息检索、学习辅导、创意写作、语言翻译和技术支持等;\\n\\n##约束\\n始终主动、礼貌、有条理;\\n回答准确但不冗长,必要时可提供简洁总结+详细解释;\\n不清楚的任务会主动澄清,不假设、不误导。"
"ThinkingType": "disabled" // 建议关闭
即自行在火山方舟开通的模型,以下场景下使用的是自定义开通的模型资源:
使用自定义开通的方舟模型,产生的 LLM 费用独立计费,不会折算为 Tokens,不可通过 Tokens 资源包抵扣,费用由火山方舟收取。 接口 StartVoiceChat(2025-06-01) 示例:
"Mode": "ArkV3", // 必填,固定值
"ModelName": "ep-xxxxxxxx", // 必填,方舟模型的 Model ID 或 接入点 ID
"APIKey": "ark-xxxxxx", // 必填,替换为您的 API Key
"##人设\\n你是一个全能的超级助手,具备强大的知识库、情感理解能力和解决问题的能力。你的目标是高效、专业、友好地帮助用户完成各类任务,包括但不限于日常生活、工作安排、信息检索、学习辅导、创意写作、语言翻译和技术支持等;\\n\\n##约束\\n始终主动、礼貌、有条理;\\n回答准确但不冗长,必要时可提供简洁总结+详细解释;\\n不清楚的任务会主动澄清,不假设、不误导。"
"ThinkingType": "disabled" // 建议关闭
旧版接口 StartVoiceChat(2024-12-01)示例:
"Mode": "ArkV3", // 必填,固定值
"EndPointId": "ep-xxxxxxxx", // 必填,方舟模型接入点 ID
"##人设\\n你是一个全能的超级助手,具备强大的知识库、情感理解能力和解决问题的能力。你的目标是高效、专业、友好地帮助用户完成各类任务,包括但不限于日常生活、工作安排、信息检索、学习辅导、创意写作、语言翻译和技术支持等;\\n\\n##约束\\n始终主动、礼貌、有条理;\\n回答准确但不冗长,必要时可提供简洁总结+详细解释;\\n不清楚的任务会主动澄清,不假设、不误导。"
"ThinkingType": "disabled" // 建议关闭
为了提供更优质的服务,我们会随火山方舟逐步下线部分旧版本模型。具体请参考模型和音色下线公告。
对话上下文管理
使用火山方舟平台时,模型的上下文由 SystemMessages + UserPrompts + HistoryLength(最近 N 轮对话)共同组成。具体参见上下文管理(短期记忆)。 Function Calling
视觉和图片理解
使用具备视觉理解能力的方舟模型时,可通过配置 VisionConfig,将实时视频流或外部图片数据发送给 LLM,实现图像问答、环境感知等高级交互。详细配置及使用方法,请参考视频和图片理解。 通过 MCP(模型上下文协议),您可以将知识库问答(RAG)、联网搜索、业务 API 调用等外部服务封装为标准化工具,让 LLM 在对话中能智能地调用它们,以获取所需的数据或执行操作,并基于返回的结果生成更准确、专业的回复。具体实现方式,请参见接入 MCP。 - 设置 Prefill: true,将 ASR 的中间结果提前送入大模型处理,可显著降低首字延迟,但会增加 Token 消耗。
- 若使用支持深度思考的模型(如 Doubao-thinking),建议将 ThinkingType 设置为 disabled 以关闭思考模式,避免回复延迟过高影响实时对话体验。
通过 LLMConfig.ServiceTier 字段,可控制模型的推理方式。根据接入模式不同,分为以下两种情况:
说明
- 接入内置模型时,ServiceTier 用于控制方舟在线推理方式。不同的方式决定了算力资源的分配、并发保障以及模型响应速度。推理方式说明及对比,参见推理方式概述。
- 接入自由模型时,系统会将该值以 service_tier 字段透传到模型服务请求体中,由模型服务自行识别和处理。
快速接入
使用 Coze 平台时,StartVoiceChat.LLMConfig 结构核心配置参数如下:
"Mode": "CozeBot", // 必填,固定为 CozeBot
"Url": "https://api.coze.cn", // 必填,固定值
"BotId": "73****68", //必填,Coze 智能体 ID
"APIKey": "czu_UEE2mJn6****MHxLCVv9uQ7H", // 必填,Coze 访问密钥
"UserId": "123" // 必填,标识当前与智能体对话的用户
进阶配置
降低延迟
- 降低请求延迟:在输入请求地址时,可使用 https://bot-open-api.bytedance.net内网域名,时延更小更稳定。
- 降低回复延迟:设置 Prefill: true。将 ASR 的中间结果提前送入大模型处理,可显著降低首字延迟,但会增加 Token 消耗。
变量传参
支持将业务数据动态注入到 Coze 智能体的提示词或工作流中。
- 你可以通过 UpdateVoiceChat 接口更新模型的部分配置(例如 SystemMessages、Tools),具体支持的配置,请参见 UpdateVoiceChat 接口的 Parameters.Config.LLMConfig 字段。
- 其他配置则需调用 StopVoiceChat 接口停止当前对话任务,随后在 StartVoiceChat.LLMConfig 中传入新的大模型配置,并重新启动对话任务。
- 对话过程中,一分钟前生成的结果,现在再提问,AI 已经不记得之前回答结果了怎么办?
- 可适当调大 LLMConfig.HistoryLength 参数,增大上下文存储长度。
最近更新时间:2026.10.10 11:59:11