zhipuai 是由 智谱AI（Zhipu AI）提供的一个官方 Python SDK，用于调用其大模型 API，如：

• GLM
• GLM-Edge
• GLM-130B
• ChatGLM 系列模型

通过 zhipuai 这个 Python 包，你可以方便地在自己的项目中接入这些大语言模型，实现文本生成、对话、摘要、翻译、代码理解等多种任务。

---

📦 什么是 zhipuai 包？

• 开发者：智谱AI（Zhipu AI）
• 用途：访问智谱开放平台上的大模型服务
• 支持功能：
  • 同步调用（requests 方式）
  • 异步调用（sse 流式输出）
  • 多模型选择（GLM、GLM-Edge 等）
• 官网地址：https://open.bigmodel.cn
• 文档地址：https://open.bigmodel.cn/dev/api

---

🔐 使用前提

要使用 zhipuai 包，你需要：

1. 注册 智谱开放平台账号
2. 创建应用，获取你的 API Key
3. 安装 zhipuai Python 包

---

🚀 安装方式

pip install zhipuai

---

🧪 快速入门示例

示例1：同步调用 GLM 模型生成内容

from zhipuai import ZhipuAI

# 初始化客户端，替换 YOUR_API_KEY 为你自己的 API 密钥
client = ZhipuAI(api_key="YOUR_API_KEY")

# 调用 GLM 模型进行文本生成
response = client.chat.completions.create(
    model="glm",  # 可选：glm / glm-3t / glm-4 等
    prompt="请写一篇关于人工智能的短文。",
)

# 输出结果
print(response.choices[0].message.content)

---

示例2：流式输出（SSE）

import time
from zhipuai import ZhipuAI

client = ZhipuAI(api_key="YOUR_API_KEY")

response = client.chat.completions.create(
    model="glm",
    prompt="讲一个关于未来科技的故事。",
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="")
    time.sleep(0.05)  # 控制输出速度

---

⚙️ 支持的模型（model 参数）

模型名	描述
glm	标准 GLM 模型，适合通用场景
glm-3t	支持三段式输入（prompt + prefix + suffix）
glm-4	最新版本 GLM-4，更强更全面
chatglm_pro / chatglm_std / chatglm_lite	ChatGLM 系列模型（已逐步被 GLM 替代）

注意：不同模型的功能和输入格式略有差异，建议参考官方文档。

---

📄 请求参数说明

参数名	类型	描述
model	str	使用的模型名称
prompt	str	用户输入的提示词
temperature	float	控制生成随机性（0~1，默认 0.95）
top_p	float	核采样概率阈值（默认 0.7）
max_tokens	int	限制最大输出长度（默认 2048）
stream	bool	是否启用流式输出（True/False）

---

🛡️ 安全与权限控制

• 所有请求都需携带 api_key
• 支持 IP 白名单控制访问权限
• 支持按应用维度设置调用频率限制（QPS）

---

📊 典型应用场景

场景	示例
自动写作	写文章、写邮件、写剧本
对话机器人	客服助手、虚拟助手
数据处理	提取信息、数据清洗、翻译
教育辅导	题目解析、学习建议
编程辅助	代码解释、生成、调试建议

---

✅ 总结

功能	描述
中文支持	✔️（原生中文训练模型）
易用性	✔️（SDK 简洁清晰）
支持模型	✔️（GLM、GLM-4、ChatGLM 系列）
推荐场景	文本生成、对话系统、智能客服、教育、编程辅助

---

如果你正在做以下项目，推荐使用 zhipuai：

• 想开发一个中文聊天机器人
• 需要生成高质量中文内容（如新闻、报告）
• 希望快速接入 GLM 或 GLM-4 模型进行推理
• 希望在企业内部部署 AI 辅助系统（无需训练模型）