修改场景版本。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| bailianvoicebot:UpdateApplicationVersion | update | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| BusinessUnitId | string | 是 | 百炼业务空间 ID | llm-c11iig67g863rih8 |
| ApplicationId | string | 是 | 应用 ID | a395011f-a247-400f-bc69-28796749fd52 |
| VersionId | string | 是 | 版本 ID | 20904943-f711-494f-9f1f-e7f340f37707 |
| TranscriberConfig | object | 否 | ASR 配置 | |
| NlsAccessType | string | 否 | ASR 调用方式 | MANAGED |
| NlsEngine | string | 否 | ASR 引擎 | ALIYUN |
| SynthesizerConfig | object | 否 | TTS 配置 | |
| NlsAccessType | string | 否 | TTS 调用方式 | MANAGED |
| NlsEngine | string | 否 | TTS 引擎 | ALIYUN |
| Voice | string | 否 | 发音人 | aixia |
| SpeechRate | integer | 否 | 语速 | 3 |
| Volume | integer | 否 | 音量 | 50 |
| PitchRate | integer | 否 | 音调 | 1 |
| ScriptProfile | object | 是 | 模型配置 | |
| Model | string | 否 | 模型 | qwen-plus |
| AgentProfile | object | 否 | 智能体配置 | |
| ScriptProfileTemplateId | string | 否 | 配置模版 ID | SFM_PROMPTS_DEFAULT |
| PromptsJson | string | 否 | 提示词配置 | {"prompts":"我是一个聊天机器人。"} |
| Name | string | 否 | 智能体名称 | 语音机器人 |
| Description | string | 否 | 智能体描述 | 语音机器人 |
| InteractionConfig | object | 否 | 交互配置 | |
| SilenceDetectionConfig | object | 否 | 静默检测配置 | |
| Timeout | integer | 否 | 超时时长（毫秒） | 5000 |
| RagConfig | object | 否 | RAG 配置 | |
| RagEngine | string | 否 | RAG 引擎 | BAILIAN |
| Enabled | boolean | 否 | 是否启用 RAG | false |
| KnowledgeBaseIds | array | 否 | 知识库 ID 列表 | |
| string | 否 | 知识库 ID | 3678xghryt | |
| TopN | integer | 否 | 取最大多少条数据 | 5 |
| MaxContentLength | integer | 否 | RAG 内容最大拼接长度 | 2000 |
| ToolConfig | object | 否 | 工具配置 | |
| McpServers | array<object> | 否 | MCP 信息配置列表 | |
| object | 否 | |||
| Name | string | 否 | 名称 | phone-ai-call |
| BaseUrl | string | 否 | 基础 URL | https://example.com |
| SseEndpoint | string | 否 | SSE 路径 | /phone-ai-call/mcp/sse?key=value |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "successful",
"RequestId": "CF6D3484-19A1-5C77-863B-AC8B5754D37C",
"Data": "82ea16d1-425c-4c03-9be5-cc91de9779ed"
}错误码
| HTTP status code | 错误码 | 错误信息 |
|---|---|---|
| 400 | Parameter.Enumeration | The parameter %s must be one of the value of enumeration %s. |
| 400 | Parameter.Blank | The parameter %s must not be null or empty. |
| 400 | Parameter.Empty | The parameter %s may not be null or empty. |
| 400 | Parameter.Null | The parameter %s may not be null. |
| 403 | Permission.Unauthorized | You are not authorized to perform this action. %s privileges are required. |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2026-05-21 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2026-05-20 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2026-05-12 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2026-05-06 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2026-04-02 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2026-01-28 | 新增 OpenAPI | 查看变更详情 |