VI ▾
Lấy khóa API

Hướng dẫn nhanh cho người dùng GLM

Hướng dẫn nhanh này hướng dẫn nhà phát triển cách tích hợp API GLM bằng các SDK tương thích OpenAI tiêu chuẩn. Nội dung bao gồm xác thực, hoàn tất văn bản cơ bản, truyền phát và gọi hàm với các ví dụ cụ thể.

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ụcGiá trị
Định dạngtương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa
ID mô hìnhuncensored
EndpointPOST /v1/chat/completions · GET /v1/models
Xác thựcAuthorization: Bearer YOUR_KEY
Base URLhttps://api.glmapi.cc/v1
Tham sốtemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Cửa sổ ngữ cảnh100.000 token (đầu vào + đầu ra)
Đầu ra tối đatố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àmcó — 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
Streamingcó — server-sent events; phần cuối chứa lượng token đã dùng
Chế độ JSONresponse_format: {"type": "json_object"}
Yêu cầu đồng thờitối đa 8 cùng lúc cho mỗi khóa
Kích thước yêu cầutối đa 8 MB
Header phản hồiX-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ềnUSDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đến $500
Thời hạntí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 dungcho 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ậpGoogle hoặc email và mật khẩu
Khóamỗ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
400bad_requestJSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh
401missing_key · invalid_key · key_revokedthiếu khóa, sai khóa hoặc khóa đã bị thay
402no_credithết tín dụng — nạp tiền là dùng tiếp ngay
403content_blockednội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí
404not_foundendpoint không tồn tại
413request_too_largenội dung lớn hơn 8 MB
429rate_limited · concurrencyvượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại
503upstream_busymô 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.

Lấy khóa APIĐọc tài liệu