Zhipu GLM

直连与本站网关

智谱直连 OpenAI 兼容 Base URL 为 https://open.bigmodel.cn/api/paas/v4/，使用 Bearer API Key；官方快速开始当前示例模型为 glm-5.2。本站使用本站 Base URL、本站 Bearer 令牌和模型列表中的启用名称，本页仅声明 /v1/chat/completions，智谱其他原生或异步接口不是本站入口。

OpenAI 兼容与模型能力

基础 OpenAI SDK 迁移通常只替换 Key、Base URL 和 model，但多模态、推理内容、平台工具和错误字段仍需按智谱文档处理。对话结构可以承载文本、图片、音频、视频或文件，实际支持取决于精确模型；图像或视频生成等任务仍使用专用接口。

工具执行边界

function 工具通常只让模型生成函数名和参数，应用必须校验权限、类型和副作用，执行后再回传 tool 结果。retrieval、web_search 或 MCP 等平台工具可能由服务端处理并返回特定类型结果。客户端应按响应 type 区分“待本地执行”和“平台已处理”，不能把所有工具一律再次执行。

流式、错误与限流

流式响应可能包含内容、reasoning_content、tool calls 或平台工具结果，通用客户端要按字段和事件类型解析。保留请求 ID、HTTP 状态与业务码，区分鉴权、参数、模型能力、余额和限流；只对明确可重试错误做有限指数退避，并设置并发和超时。

费用与上线检查

模型、套餐、并发、上下文和价格会变化。限制最大输出、工具权限和搜索范围，设置账户告警；上线前用真实样本验证输入模态、结构化输出、工具闭环、延迟、token 与错误恢复，不要只验证一条普通文本请求。