GLM API: 三行程式碼切換客戶端
透過更新兩個設定值,在幾分鐘內將現有的程式碼連接到無審查的 GLM API。此快速入門指南將引導你使用預付額度透過標準 OpenAI 相容端點進行操作。
先決條件:取得金鑰
在編寫程式碼之前,您需要 API 金鑰。前往本站的 取得 API 金鑰 頁面,使用電子郵件和密碼登入。開始使用無需電話號碼或信用卡。註冊後,您將獲得 7 天有效的 $0.50 免費試用額度,或使用加密貨幣(USDT 或 USDC)儲值。您的金鑰將在註冊後立即顯示。請安全儲存,因為您可以隨時重新產生金鑰以撤銷舊金鑰。
此金鑰用於驗證所有對我們 glm api 端點的請求。我們不會將您的提示詞用於訓練,且金鑰與單一帳戶綁定。如果您需要更高的請求量,可以購買永不過期的預付額度。
設定 Base URL 和金鑰
要將我們的服務作為 OpenAI 的即插即用替代品使用,你必須將 SDK 指向我們的 base URL。這是唯一需要的基礎設施變更。Base URL 為https://api.glmapikey.com/v1。你還需要將授權標頭或 SDK 客戶端金鑰設定為註冊時收到的值。
大多數 OpenAI 相容的客戶端,包括官方的 Python 和 Node SDK,都允許你覆蓋 base URL。這允許你在切換底層模型的同時保留現有的應用程式邏輯。在發送請求之前,請確保正確設定金鑰,以避免驗證錯誤。
發送第一個聊天完成請求
發送 POST 請求至 /v1/chat/completions 以生成文本。我們的模型接受標準訊息結構,包含 user 和 assistant 等角色。您必須指定的模型 ID 為 uncensored。這會觸發託管在我們 GPU 上的開放權重模型,該模型經過調整,可在合法成人用途下無內容審查地回答問題。
回應將包含生成文本的 JSON。如果遇到 401 錯誤,請驗證您的金鑰。如果看到 402,表示您的預付額度已耗盡。您可以從 $10 開始儲值。注意,此端點不支援嵌入、圖像或微調。
使用 Python SDK
官方的 OpenAI Python 庫可直接與我們的 API 配合使用。使用你的金鑰和特定的 base URL 初始化客戶端。這種方法非常適合需要結構化 JSON 回應的後端服務或腳本。客戶端會自動處理序列化和重試邏輯。
傳遞模型名稱 uncensored 以確保您連接到我們特定的端點。上下文視窗支援提示詞與完成 token 合計最多 100,000 個 token。這允許在不截斷的情況下處理大量輸入資料,前提是您保持在 8 MB 請求主體限制內。
使用 Node SDK
對於 JavaScript 和 TypeScript 應用程式,openai NPM 套件相容。使用與 Python 範例相同的基礎 URL 和金鑰配置用戶端。這可啟用需要無審查文本生成的伺服器端渲染或 API 端點。如果配置正確,SDK 將有效串流輸出資料。
此 SDK 支援函式呼叫。你可以在請求中定義函式結構描述,模型將返回與你的結構描述匹配的結構化 JSON 輸出。這使得將外部數據源或動作整合到你的應用程式流程中變得容易,無需解析原始文本。
啟用串流回應
在請求中設定stream: true以接收伺服器發送的事件 (SSE)。這允許你在生成文本時向用戶顯示文本,從而改善感知延遲。API 返回文本區塊,你的客戶端必須將其連接或增量渲染。
Python 和 Node SDK 都支援串流輸出。它對於期望立即反饋的聊天介面特別有用。每個區塊包含回應的一部分。模型會繼續生成,直到完成或達到上下文視窗限制。如果使用帶有串流輸出的函式呼叫,請確保你的客戶端正確處理部分 JSON 結構。
限制、錯誤與模型
我們的 API 對每個金鑰實施每分鐘 300 次請求的速率限制。如果超過此限制,你將收到 429 錯誤。最大請求主體大小為 8 MB。對於模型發現,請使用GET /v1/models端點。它返回可用模型列表,包括uncensored模型 ID。
常見錯誤包括無效金鑰的 401 和額度不足的 402。額度不會過期,但試用額度有效期為 7 天。我們不提供服務等級協議或認證。該模型會阻止涉及未成年人的色情內容,但除此之外無審查。請根據這些限制設計您的重試邏輯和用戶通知。
cURL
curl https://api.glmapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.glmapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.glmapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);串流輸出
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)技術規格
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 模型 ID | uncensored |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.glmapikey.com/v1 |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 請求大小 | 每次請求不超過 8 MB |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
| 登入 | Google 或電子郵件 + 密碼 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
錯誤代碼
錯誤以 JSON 回傳,type 欄位固定;失敗或被拒絕的請求不計費。
| 狀態碼 | 類型 | 含義 |
|---|---|---|
400 | bad_request | JSON 無效、訊息為空、參數錯誤或超出上下文視窗 |
401 | missing_key · invalid_key · key_revoked | 缺少金鑰、金鑰錯誤或已被新金鑰取代 |
402 | no_credit | 餘額不足——儲值後立即恢復 |
403 | content_blocked | 涉及未成年人的性內容——拒絕且不計費 |
404 | not_found | 未知端點 |
413 | request_too_large | 請求內容超過 8 MB |
429 | rate_limited · concurrency | 超過每分鐘 300 次或 8 個並行——稍後重試 |
503 | upstream_busy | 模型忙碌——幾秒後重試 |
問答
這是官方的 GLM API 嗎?
不是,我們是獨立服務。我們託管開放權重無審查模型,並提供 OpenAI 相容的端點。我們與原始的 GLM 創建者或其他主要 AI 供應商沒有關聯。
我可以使用現有的 OpenAI 金鑰嗎?
不行,你需要來自我們網站的金鑰。不過,你可以使用用於 OpenAI 的相同 SDK 程式碼,只需在客戶端配置中更改 base URL 和金鑰即可。
如果我額度用完了會怎樣?
請求將返回 402 錯誤。您可以隨時使用加密貨幣(USDT 或 USDC)為預付額度儲值。您的額度永不過期,因此您可以在需要時隨時添加資金。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改 base URL。這就是整個設定過程。