中文 ▾
获取 API 密钥

GLM 用户快速入门

本快速入门指南指导开发者使用标准的 OpenAI 兼容 SDK 集成 GLM API。涵盖身份验证、基本补全、流式输出和函数调用,并附带具体示例。

安装与配置

首先,请确保已安装对应语言的官方 OpenAI SDK。该 API 使用标准的基于请求头的认证方案。你必须设置 Authorization 请求头为 Bearer your-api-key,并将基础 URL 配置为 https://api.glmapi.cc/v1。此 URL 适用于任何支持 OpenAI Chat Completions 格式的客户端。

除标准配置外,无需特殊的客户端初始化。该服务可作为现有 OpenAI 集成的即插即用替代品。你可以通过检查可用模型接口来验证设置。

首次请求

发送简单的文本补全请求以测试连接性。使用模型标识符 uncensored 作为主大语言模型。API 接受标准参数,如 max_tokens 和 temperature。

此请求返回直接文本响应。如果遇到 401 错误,请验证你的 API 密钥。402 错误表示预付额度不足。

curl https://api.glmapi.cc/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 SDK 集成

使用官方 Python 库与 API 交互。使用你的基础 URL 和 API 密钥初始化客户端。语法与标准 OpenAI 客户端结构一致。

此方法允许你在不重写业务逻辑的情况下更换提供商。模型响应标准提示词格式。你可以通过标准参数控制输出长度和随机性。

from openai import OpenAI

client = OpenAI(base_url="https://api.glmapi.cc/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 SDK 集成

对于 JavaScript 环境,请使用 Node SDK。配置 baseUrl 以指向我们的 API 接口。这确保所有请求正确路由到我们的服务器。

SDK 自动处理重试和响应解析。你可以传递标准的补全参数。响应对象在预期位置包含生成的文本。

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapi.cc/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 参数设置为 true 来启用流式输出。API 通过服务器发送事件 (SSE) 返回数据块。每个数据块包含部分文本和使用统计信息。

此方法可降低长响应的感知延迟。你可以处理到达的 token。最后一个数据块包含用于计费的总 token 数。

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)

限制、错误与上下文

上下文窗口总共支持 100,000 个 token,最大输出为 32,000 个 token。超过 8 MB 主体限制请求将失败。你每分钟受限 300 次请求,每个密钥受限 8 个并发请求。

401 错误表示密钥无效。402 错误表示没有剩余的预付额度。429 错误表示速率限制。额度永不过期,错误不会消耗 token。保持隐私;提示词不用于训练。

接口能力与限制

购买额度前,请先确认接口是否满足你的需求——以下是全部真实参数。

项目说明
接口格式兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥
模型 IDuncensored
接口POST /v1/chat/completions · GET /v1/models
认证Authorization: Bearer YOUR_KEY
Base URLhttps://api.glmapi.cc/v1
采样参数temperature、top_p、stop、seed、presence_penalty、frequency_penalty
上下文窗口100,000 tokens(输入与输出合计)
最大输出不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选
函数调用支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回
流式输出支持 SSE,最后一块包含 token 用量
JSON 模式response_format: {"type": "json_object"}
并发每个密钥同时最多 8 个请求
请求大小每次请求不超过 8 MB
响应头X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency
速率限制每个密钥每分钟 300 次请求
充值USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额
额度有效期付费额度永不过期,无订阅
赠送额度满 $50 送 5%,满 $100 送 10%,满 $200 送 15%
计费预付额度,按实际 token 用量扣费;错误和拒绝不收费
免费试用$0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300)
价格输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens
内容政策允许成人内容;涉及未成年人的性内容一律拒绝
登录Google 或邮箱 + 密码
密钥每个账户一个有效密钥;生成新密钥后旧密钥失效

错误代码

错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。

状态码类型含义
400bad_requestJSON 无效、消息为空、参数错误或超出上下文窗口
401missing_key · invalid_key · key_revoked缺少密钥、密钥错误或已被新密钥替换
402no_credit余额不足——充值后立即恢复
403content_blocked涉及未成年人的性内容——拒绝且不计费
404not_found未知接口
413request_too_large请求体超过 8 MB
429rate_limited · concurrency超过每分钟 300 次或 8 个并发——稍后重试
503upstream_busy模型繁忙——几秒后重试

问答

这是官方的 GLM API 吗?

并非如此,这是一个独立的服务。我们运行自己的无审查模型,并提供 OpenAI 兼容的接口。它与原始的 GLM 开发者无关。

我如何为 API 付费?

我们接受加密货币(TRC20 网络上的 USDT,Base 网络上的 USDC)充值。最低充值额为 $20。预付额度按 token 使用量计费,且永不过期。

上下文窗口大小是多少?

模型支持 100,000-token 上下文窗口。除非另有说明,否则每次请求的最大输出为 32,000 个 token。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。

获取 API 密钥阅读文档