Cài đặt và Cấu hình
Để bắt đầu, hãy đảm bảo bạn đã cài đặt SDK OpenAI chính thức cho ngôn ngữ của bạn. API sử dụng cơ chế xác thực dựa trên tiêu chuẩn. Bạn phải đặt tiêu đề Authorization thành Bearer your-api-key và định cấu hình base URL thành https://api.glmapi.cc/v1. URL này hoạt động với bất kỳ ứng dụng khách nào hỗ trợ định dạng Chat Completions của OpenAI.
Không cần khởi tạo ứng dụng khách đặc biệt ngoài cấu hình tiêu chuẩn. Dịch vụ hoạt động như một giải pháp thay thế trực tiếp cho các tích hợp OpenAI hiện có. Bạn có thể xác minh thiết lập của mình bằng cách kiểm tra endpoint mô hình có sẵn.
Yêu cầu đầu tiên
Gửi một yêu cầu hoàn thành văn bản đơn giản để kiểm tra kết nối. Sử dụng định danh mô hình uncensored cho mô hình ngôn ngữ lớn chính. API chấp nhận các tham số tiêu chuẩn như max_tokens và temperature.
Yêu cầu này trả về phản hồi văn bản trực tiếp. Nếu gặp lỗi 401, hãy xác minh khóa API của bạn. Lỗi 402 cho biết tín dụng trả trước không đủ.
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."}]
}'
Tích hợp SDK Python
Sử dụng thư viện Python chính thức để tương tác với API. Khởi tạo ứng dụng khách với base URL và khóa API của bạn. Cú pháp giống với cấu trúc ứng dụng khách OpenAI tiêu chuẩn.
Cách tiếp cận này cho phép bạn thay đổi nhà cung cấp mà không cần viết lại logic kinh doanh. Mô hình phản hồi theo các định dạng prompt tiêu chuẩn. Bạn có thể kiểm soát độ dài và tính ngẫu nhiên của đầu ra thông qua các tham số tiêu chuẩn.
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)
Tích hợp SDK Node.js
Đối với môi trường JavaScript, hãy sử dụng SDK Node.js. Định cấu hình baseUrl trỏ đến endpoint API của chúng tôi. Điều này đảm bảo tất cả yêu cầu được định tuyến chính xác đến máy chủ của chúng tôi.
SDK tự động xử lý việc thử lại và phân tích phản hồi. Bạn có thể truyền các tham số hoàn tất tiêu chuẩn. Đối tượng phản hồi chứa văn bản được tạo ở vị trí dự kiến.
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);
Phản hồi truyền phát
Bật truyền phát bằng cách đặt tham số stream thành true. API trả về các chunk qua Server-Sent Events (SSE). Mỗi chunk chứa văn bản một phần và thống kê sử dụng.
Phương pháp này giảm độ trễ cảm nhận được cho các phản hồi dài. Bạn có thể xử lý token khi chúng đến. Chunk cuối cùng bao gồm tổng số token để tính phí.
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)
Giới hạn, Lỗi và Ngữ cảnh
Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token, với tối đa 32.000 token đầu ra. Các yêu cầu vượt quá giới hạn thân 8 MB sẽ thất bại. Bạn bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa.
Lỗi 401 nghĩa là khóa không hợp lệ. Lỗi 402 cho biết không còn tín dụng trả trước. Lỗi 429 báo hiệu giới hạn tốc độ. Tín dụng không bao giờ hết hạn và lỗi không tiêu thụ token. Quyền riêng tư được duy trì; prompt không được sử dụng để huấn luyện.
Thông số kỹ thuật
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| ID mô hình | uncensored |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.glmapi.cc/v1 |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Kích thước yêu cầu | tối đa 8 MB |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đến $500 |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Thưởng | +5% từ $50, +10% từ $100, +15% từ $200 |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
| Đăng nhập | Google hoặc email và mật khẩu |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| Mã | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Hỏi đáp
Đây có phải là API GLM chính thức không?
Không, đây là dịch vụ độc lập. Chúng tôi vận hành mô hình không kiểm duyệt của riêng mình và cung cấp giao diện tương thích OpenAI. Dịch vụ không liên kết với nhà phát triển GLM gốc.
Tôi thanh toán cho API như thế nào?
Chúng tôi chấp nhận nạp tiền bằng tiền điện tử (USDT trên TRC20, USDC trên Base). Nạp tiền tối thiểu là $20. Tín dụng trả trước được tính phí theo mức sử dụng token và không bao giờ hết hạn.
Kích thước cửa sổ ngữ cảnh là bao nhiêu?
Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token. Lượng đầu ra tối đa cho mỗi yêu cầu là 32.000 token, trừ khi có quy định khác.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ quy trình cài đặt.