大模型服务平台百炼：客户端事件

typestring（必选）

事件类型，固定为 session.update。

{
    "event_id": "event_ToPZqeobitzUJnt3QqtWg",
    "type": "session.update",
    "session": {
        "modalities": [
            "text",
            "audio"
        ],
        "model": "qwen3.5-omni-flash-realtime",
        "voice": "Tina",
        "audio": {
            "input": {
                "format": {
                    "type": "pcm",
                    "sample_rate": 16000
                }
            },
            "output": {
                "format": {
                    "type": "wav",
                    "sample_rate": 24000
                }
            }
        },
        "instructions": "你是某五星级酒店的AI客服专员，请准确且友好地解答客户关于房型、设施、价格、预订政策的咨询。请始终以专业和乐于助人的态度回应，杜绝提供未经证实或超出酒店服务范围的信息。",
        "turn_detection": {
            "type": "server_vad",
            "threshold": 0.5,
            "silence_duration_ms": 800
        },
        "enable_search": true,
        "search_options": {
            "enable_source": true
        },
        "tools": [
            {
                "type": "function",
                "function": {
                    "name": "get_current_weather",
                    "description": "当你想查询指定城市的天气时非常有用。",
                    "parameters": {
                        "type": "object",
                        "properties": {
                            "location": {
                                "type": "string",
                                "description": "城市或县区，比如北京市、杭州市、余杭区等。"
                            }
                        },
                        "required": ["location"]
                    }
                }
            }
        ],
        "seed": 1314,
        "max_tokens": 16384,
        "repetition_penalty": 1.05,
        "presence_penalty": 0.0,
        "top_k": 50,
        "top_p": 1.0,
        "temperature": 0.9
    }
}

sessionobject（可选）

会话配置。

Qwen3.8-Omni-Flash-Realtime 更新会话时必须提供 session。全部输入 Token 总数上限为 196608，输入长度计算规则与 Qwen3.5-Omni-Realtime 一致。

temperaturefloat（可选）

采样温度，控制输出内容的多样性。值越高，输出越多样；值越低，输出越确定。

取值范围：[0, 2)。

由于 temperature 和 top_p 均可控制多样性，建议只设置其中一个。

默认值：

• qwen3.8-omni-flash-realtime：0.6
• Qwen3.5-Omni-Realtime 系列模型：0.7
• qwen3-omni-flash-realtime 系列：0.9
• qwen-omni-turbo-realtime 系列：1.0

qwen-omni-turbo 系列模型不支持修改。

top_pfloat（可选）

核采样概率阈值，控制输出内容的多样性。值越高，输出越多样；值越低，输出越确定。

取值范围：(0, 1.0]。

由于 temperature 和 top_p 均可控制多样性，建议只设置其中一个。

默认值：

• qwen3.8-omni-flash-realtime：0.95
• Qwen3.5-Omni-Realtime 系列模型：0.8
• qwen3-omni-flash-realtime 系列：1.0
• qwen-omni-turbo-realtime 系列：0.01

qwen-omni-turbo 系列模型不支持修改。

top_kinteger（可选）

采样候选集大小。例如设为 50 时，每步生成仅从得分最高的 50 个 Token 中采样。值越大，随机性越高；值越小，确定性越高。设为 null 或大于 100 时，禁用 top_k 策略，仅 top_p 生效。

取值需大于或等于 0。

默认值：

• qwen3.8-omni-flash-realtime：20
• Qwen3.5-Omni-Realtime 系列模型：20
• qwen3-omni-flash-realtime 系列：50
• qwen-omni-turbo-realtime 系列：20

qwen-omni-turbo 系列模型不支持修改。

max_tokensinteger（可选）

本次请求返回的最大 Token 数。

max_tokens 不影响模型的生成过程。若模型生成的 Token 数超过 max_tokens，响应将被截断。

qwen3.8-omni-flash-realtime 的取值范围为 [1, 65536]。其他模型的默认值和最大值均为模型的最大输出长度，各模型的最大输出长度参见模型列表。

适用于需要限制输出长度的场景，如生成摘要或关键词、控制成本、缩短响应时间等。

qwen-omni-turbo 系列模型不支持修改。

repetition_penaltyfloat（可选）

控制生成内容中连续序列的重复度。值越高，重复惩罚越强；1.0 表示不做惩罚。qwen3.8-omni-flash-realtime 支持取值 0；其他模型取值需大于 0，无严格上限。

默认值：

• qwen3.8-omni-flash-realtime：0
• Qwen3.5-Omni-Realtime 系列模型：1.0
• qwen3-omni-flash-realtime 系列：1.05
• qwen-omni-turbo-realtime 系列：1.05

qwen-omni-turbo 系列模型不支持修改。

presence_penalty float（可选）

控制生成内容的重复度。

取值范围：[-2.0, 2.0]。正数降低重复度，负数增加重复度。

默认值：

• qwen3.8-omni-flash-realtime：1
• Qwen3.5-Omni-Realtime 系列模型：1.5
• qwen3-omni-flash-realtime 系列：0.0
• qwen-omni-turbo-realtime 系列：0.0

适用场景：

较高值适合创意写作、头脑风暴等需要多样性和创造性的场景。

较低值适合技术文档等需要一致性和专业术语的场景。

qwen-omni-turbo 系列模型不支持修改。

seedinteger（可选）

提高生成过程的确定性，常用于在相同参数下复现相同结果。

每次调用时传入相同的 seed 值并保持其他参数不变，模型将尽可能返回相同的结果。

取值范围：0 到 2³¹−1，默认值为 -1。

qwen-omni-turbo 系列模型不支持修改。

typestring（必选）

事件类型，固定为 response.create。

{
    "type": "response.create",
    "event_id": "event_1718624400000"
}

typestring（必选）

事件类型，固定为 response.cancel。

{
    "event_id": "event_B4o9RHSTWobB5OQdEHLTo",
    "type": "response.cancel"
}

typestring（必选）

事件类型，固定为 input_audio_buffer.append。

{
    "event_id": "event_B4o9RHSTWobB5OQdEHLTo",
    "type": "input_audio_buffer.append",
    "audio": "UklGR..."
}

audiostring（必选）

Base64 编码的音频数据。

typestring（必选）

事件类型，固定为 input_audio_buffer.commit。

{
    "event_id": "event_B4o9RHSTWobB5OQdEHLTo",
    "type": "input_audio_buffer.commit"
}

typestring（必选）

事件类型，固定为 input_audio_buffer.clear。

{
    "event_id": "event_xxx",
    "type": "input_audio_buffer.clear"
}

typestring（必选）

事件类型，固定为 input_image_buffer.append。

{
    "event_id": "event_xxx",
    "type": "input_image_buffer.append",
    "image": "xxx"
}

imagestring（必选）

Base64 编码的图像数据。

typestring（必选）

事件类型，固定为 conversation.item.create。

{
    "event_id": "event_55099cddb51b4f208cb95d1a994eef80",
    "type": "conversation.item.create",
    "item": {
        "id": "item_2a80d7682b4e473c9c2154da135041e9",
        "type": "function_call_output",
        "call_id": "call_62c24725afdb4c2680ac54",
        "output": "北京今天天气为霾转晴，气温4/-4℃，微风"
    }
}

itemobject（必选）

要创建的对话项，不能为空。