智譜清言API怎麼用：GLM API Key獲取、免費模型與Python調用

適用於誰

• 搜「智譜清言的api怎麼用」「智譜清言api」「智譜 api key」的開發者和想把 GLM 模型接進自己工具的人；
• 想找一個有免費模型可以練手的國內大模型 API 的人。

本文根據智譜 AI 開放文檔（docs.bigmodel.cn）整理，資料核對於 2026-10-11。

結論先說

1. 「智譜清言」是面向普通用戶的聊天產品，API 在另一個地方：智譜開放平台 open.bigmodel.cn（bigmodel.cn），模型系列叫 GLM。
2. 三步跑通：註冊開放平台 → 在個人中心的 API Keys 頁面創建 Key → 裝官方 SDK zai-sdk 調用。
3. 有免費模型。官方模型概覽把 GLM-4.7-Flash、GLM-4.5-Flash 等標註為免費文本模型，適合練手和輕量任務。
4. 旗艦模型是 GLM-5.3，上下文 1M、最大輸出 128K；它的深度思考是強制開啟的，傳「關閉」會報錯。
5. 價格、免費額度和限速會調整，以官方價格頁和控制台為準。

步驟

1. 註冊並創建 API Key

1. 打開智譜開放平台 open.bigmodel.cn，點右上角「註冊 / 登入」；
2. 登入後進入個人中心的 API Keys 頁面（bigmodel.cn/usercenter/proj-mgmt/apikeys），創建一個新的 Key；
3. 立刻複製儲存。官方文檔提醒不要把 Key 泄露給他人，建議放在環境變量或配置文件裏，不要寫死在代碼中。

bash
export ZHIPU_API_KEY="你的 Key"        # Windows PowerShell：$env:ZHIPU_API_KEY="你的 Key"

2. 安裝官方 SDK，發出第一個請求

bash
pip install zai-sdk

python
import os
from zai import ZhipuAiClient

client = ZhipuAiClient(api_key=os.environ["ZHIPU_API_KEY"])

resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[
        {"role": "system", "content": "你是一個嚴謹的中文助手。"},
        {"role": "user", "content": "用三句話解釋什麼是大模型的上下文長度。"},
    ],
)
print(resp.choices[0].message.content)

舊項目裏用的 zhipuai 包仍然可以安裝，官方文檔把它列為舊版 Python SDK，新項目用 zai-sdk。

不想裝 SDK 時直接發 HTTP 請求：接口地址是 https://open.bigmodel.cn/api/paas/v4/chat/completions，請求頭帶 Authorization: Bearer <你的 Key>，請求體裏寫 model 和 messages，格式與常見的對話補全接口一致。

3. 選模型

官方模型概覽（2026-10-11 核對）裏常用的文本模型：

除了文本模型，開放平台還有視覺理解（如 GLM-5.3-Flash、免費的 GLM-4.6V-Flash）、圖像生成（GLM-Image、CogView 系列）、影片生成（CogVideoX 系列）和語音模型，調用方式見各模型的文檔頁。

選擇思路：先用免費的 Flash 模型把流程跑通；效果不夠再換 GLM-4.7 或 GLM-5.3；批量、低延遲的任務看 FlashX。請求裏的 model 字段寫小寫的模型名（如 glm-5.3、glm-4.7-flash），確切寫法以各模型文檔頁為準。

4. 控制深度思考

GLM-4.5 及以上的模型支持深度思考，通過請求裏的 thinking 參數控制：

python
resp = client.chat.completions.create(
    model="glm-4.5-flash",
    messages=[{"role": "user", "content": "把下面這句話翻譯成英文：今天天氣不錯。"}],
    thinking={"type": "disabled"},     # 開啟寫 "enabled"
)

官方文檔裏幾條必須知道的規則：

• 預設是開啟的；思考過程在 reasoning_content 字段裏返回，最終回答在 content；
• GLM-5.3、GLM-5.3-Flash、GLM-4.7 是強制思考的模型，其中官方明確寫了 GLM-5.3 和 GLM-5.3-Flash 傳 disabled 會報錯；
• GLM-5.2、GLM-5.1、GLM-5、GLM-4.6、GLM-4.5 等會自動判斷要不要思考；
• 思考會增加響應時間並消耗額外 token。事實查詢、簡單翻譯這類任務，用能關閉思考的模型更省。

GLM-5.2 及以上還支持 reasoning_effort 參數，預設 max；GLM-5.3 系列可選 max、high、low。

5. 流式輸出

把 stream 設為 True，邊生成邊讀取，配合深度思考可以實時看到思考過程：

python
stream = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "寫一段 100 字的產品介紹"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if getattr(delta, "reasoning_content", None):
        print(delta.reasoning_content, end="")
    if getattr(delta, "content", None):
        print(delta.content, end="")

常見問題

Q：智譜清言 App 的會員能用來調 API 嗎？

不能混用。智譜清言是聊天產品，API 在開放平台單獨計費、單獨管理 Key。

Q：報 401？

官方錯誤碼說明：Key 無效或已過期。檢查是否複製完整、環境變量是否生效。

Q：報 429？

請求頻率超限。降低並發，加上帶退避的重試；官方建議對 429 和 500 實現重試機制。

Q：報 400？

請求參數錯誤。最常見的是模型名寫錯，或者對強制思考的模型傳了關閉思考的參數。

Q：免費模型有什麼限制？

官方模型概覽把它們標註為免費模型；免費模型一般會有並發和速率方面的限制，具體規則以控制台和官方價格頁為準。用於生產環境前先評估穩定性。

Q：能用 OpenAI 的 SDK 調嗎？

智譜的接口格式與 OpenAI 的對話補全接口相近，很多支持自定義接口地址的工具可以直接接入。兼容方式和接口地址的確切寫法以開放文檔的兼容說明為準。

Q：用 GLM 做編程助手（接入 Claude Code 等）怎麼配？

官方有單獨的 GLM Coding Plan 和專屬端點，文檔提醒要按對應教學配置，不要直接套用普通接口地址。

參考資料

• 智譜 AI 開放文檔：快速開始 — https://docs.bigmodel.cn/cn/guide/start/quick-start
• 智譜 AI 開放文檔：模型概覽 — https://docs.bigmodel.cn/cn/guide/start/model-overview
• 智譜 AI 開放文檔：深度思考 — https://docs.bigmodel.cn/cn/guide/capabilities/thinking
• 智譜開放平台：API Keys — https://bigmodel.cn/usercenter/proj-mgmt/apikeys