Khác biệt tham số và giao thức của GLM
Tìm hiểu khác biệt tham số và cách dùng mô hình GLM qua các giao thức tương thích.
Với GLM, tạo yêu cầu theo giao thức đã chọn rồi áp dụng khác biệt chính thức trên trang này. Cấu trúc đầy đủ: Chat Completions, Responses và Messages.
Mô hình áp dụng
| Mô hình | Phạm vi |
|---|---|
| GLM-5.3-FlashX, GLM-5.3-Flash | Khác biệt Chat và bổ sung đa phương thức |
| GLM-5.3 | Khác biệt Chat và Responses |
Tham số văn bản GLM-5.3
Chat Completions
| Trường | Khác biệt |
|---|---|
thinking.type | Luôn suy nghĩ; chỉ hỗ trợ enabled, không hỗ trợ disabled |
reasoning_effort | Hỗ trợ low/high/max; mặc định max |
temperature | Phạm vi 0~1, mặc định 1; tối đa hai chữ số thập phân |
top_p | Phạm vi 0.01~1, mặc định 0.95; tối đa hai chữ số thập phân. Chỉ chỉnh trường này hoặc nhiệt độ |
do_sample | Mở rộng GLM, mặc định true; đặt false sẽ bỏ qua temperature và top_p |
max_tokens | Phạm vi 1~131072; ngân sách gồm suy nghĩ và câu trả lời cuối |
tool_stream | Mở rộng GLM; để truyền đối số tăng dần, đặt trường này và stream thành true |
thinking.clear_thinking | Đặt false để giữ suy nghĩ; gửi lại toàn bộ lịch sử theo thứ tự gốc |
reasoning_content | Nội dung suy nghĩ, truyền qua delta.reasoning_content; lượt công cụ suy nghĩ xen kẽ phải gửi lại nguyên trạng cùng tool_calls trong cùng thông điệp |
request_id | Mở rộng GLM, 6–64 ký tự, có thể dùng UUID; dịch vụ tạo nếu bỏ trống |
user_id | Mở rộng GLM, 6–128 ký tự; định danh người dùng ổn định, không chứa dữ liệu nhạy cảm |
tool_choice | GLM-5.3 chỉ hỗ trợ auto |
response_format.type | GLM-5.3 hỗ trợ text hoặc json_object |
Responses
Phần này áp dụng cho GLM-5.3.
| Trường | Khác biệt |
|---|---|
model, input | Cả hai đều bắt buộc |
temperature | Phạm vi 0~1, mặc định 1; tối đa hai chữ số thập phân |
top_p | Phạm vi 0.01~1, mặc định 0.95; tối đa hai chữ số thập phân |
max_output_tokens | Gồm suy nghĩ và câu trả lời; mặc định 65536, tối đa 131072 |
reasoning.effort | Mặc định max; low/medium ánh xạ sang high, xhigh sang max |
store | Mặc định false; đặt rõ true để lưu hoặc duy trì lịch sử phía máy chủ |
previous_response_id | Tiếp tục phản hồi đã lưu; ID có hiệu lực bảy ngày |
tool_choice | Hỗ trợ none hoặc auto |
tools[].type | Hỗ trợ function, namespace, custom, web_search |
text.format.type | Hỗ trợ text hoặc json_object |
Bổ sung đa phương thức Flash / FlashX
Flash / FlashX dùng chung tham số Chat ở trên. GLM-5.3 chỉ nhận văn bản, không dùng các khối này.
| Đầu vào | Khối Chat | Trường chính |
|---|---|---|
| Hình ảnh | type: "image_url" | image_url.url nhận URL hình ảnh hoặc Base64 Data URL; mỗi ảnh dùng một khối riêng |
| Video | type: "video_url" | video_url.url |
| Tệp | type: "file" | Chọn một trong file.file_id, file.file_url, file.file_data; tối đa 50 MB mỗi tệp. Khối cũ file_url chỉ để tương thích |
Ví dụ gọi
Thay MODEL_ID bằng ID mô hình đầy đủ khả dụng ở giao thức đã chọn và dùng API Key của bạn.
Cấu hình văn bản này dùng được cho cả ba mô hình.
curl 'https://api.agtcloud.cn/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "Giải thích cách xử lý thời gian chờ API bằng ba ý"}],
"thinking": {"type": "enabled"},
"reasoning_effort": "low",
"max_tokens": 4096
}'