GLM API: 三行代码切换客户端
通过更新两个配置值,在几分钟内将现有代码连接到无审查的 GLM API。本快速入门指南将指导你使用预付额度访问标准的 OpenAI 兼容接口。
前提条件:获取密钥
在编写代码之前,你需要一个 API 密钥。访问本站的获取 API 密钥页面,使用电子邮件和密码注册。开始使用无需电话号码或信用卡。注册后,你将获得有效期为 7 天的 0.50 美元试用额度,也可以使用加密货币(USDT 或 USDC)充值。注册后立即显示你的密钥。请安全存储,因为你可以随时重新生成密钥以撤销旧密钥。
此密钥用于对所有请求进行身份验证,目标是我们glm api接口。我们不使用你的提示词进行训练,且密钥与单个账户绑定。如果需要更高吞吐量,你可以购买永不过期的预付额度。
配置基础 URL 和密钥
要将我们的服务作为 OpenAI 的即插即用替代品使用,你必须将 SDK 指向我们的基础 URL。这是唯一需要的基础设施更改。基础 URL 为https://api.glmapikey.com/v1。你还需要将授权头或 SDK 客户端密钥设置为注册时获得的值。
大多数 OpenAI 兼容客户端(包括官方 Python 和 Node SDK)允许你覆盖基础 URL。这使你在切换底层模型的同时保留现有应用程序逻辑。在发起请求之前,请确保密钥设置正确,以避免身份验证错误。
发起首次聊天完成请求
向 /v1/chat/completions 发送 POST 请求以生成文本。我们的模型接受包含 user 和 assistant 等角色的标准消息结构。你必须指定的模型 ID 是 uncensored。这将触发托管在我们 GPU 上的开放权重模型,该模型经过调整,可在合法成人用途下不拒绝内容地回答。
响应将包含生成文本的 JSON。如果遇到 401 错误,请验证你的密钥。如果看到 402,说明你的预付额度已耗尽。你可以从 10 美元开始充值。请注意,此接口不支持嵌入、图像或微调。
使用 Python SDK
官方 OpenAI Python 库可直接与我们的 API 配合使用。使用你的密钥和特定基础 URL 初始化客户端。这种方法非常适合需要结构化 JSON 响应的后端服务或脚本。客户端会自动处理序列化和重试逻辑。
传递模型名称uncensored以确保你访问的是我们的特定接口。上下文窗口支持最多 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 天。我们不提供 SLA 或认证。该模型会屏蔽涉及未成年人的色情内容,但除此之外无审查。请根据这些限制设计你的重试逻辑和用户通知。
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 密钥吗?
不行,你需要来自我们网站的密钥。不过,你只需在客户端配置中更改基础 URL 和密钥,即可使用用于 OpenAI 的相同 SDK 代码。
如果额度用完会发生什么?
请求将返回 402 错误。你可以随时使用加密货币(USDT 或 USDC)为你的预付额度充值。你的额度永不过期,因此你可以随时添加资金。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。