Dokumen ini menjelaskan cara memanggil layanan inferensi model Z.AI di Alibaba Cloud Model Studio.
Aktivasi layanan
- Buka Konsol Model Studio, cari ZHIPU/GLM, temukan kartu model teks seri GLM Z.AI, lalu klik Activate Now.
- Pada kotak dialog, konfirmasi aktivasi dan otorisasi.
Mulai cepat
ZHIPU/GLM-5.3 adalah model dalam seri GLM dan mendukung konteks hingga 1 juta token. Jalankan kode berikut untuk segera memanggil model ZHIPU/GLM-5.3 dalam mode berpikir.
Anda harus telah memperoleh Kunci API dan mengonfigurasi Kunci API sebagai variabel lingkungan. Jika Anda memanggil model menggunakan SDK, Anda juga harus menginstal SDK.
- Kompatibilitas OpenAI
enable_thinking bukan parameter standar OpenAI. Di SDK Python OpenAI, Anda meneruskannya dalam extra_body. Di SDK Node.js, Anda meneruskannya sebagai parameter tingkat atas.- Python
- Node.js
- HTTP
Kode contoh
Respons
Pemanggilan tool streaming
Model ZHIPU/GLM-5.3, ZHIPU/GLM-5.2, mendukung parameter tool_stream. Parameter ini merupakan nilai boolean dengan nilai default false dan hanya berfungsi ketika stream bernilai true. Ketika diaktifkan, arguments dari parameter tool_call pada Function calling dikembalikan secara bertahap sebagai aliran.
Parameter stream dan tool_stream bekerja bersama sebagai berikut:
stream | tool_stream | Cara |
|---|---|---|
true | true |
|
true | false (default) |
|
false | true/false |
|
- Kompatibel OpenAI
- Python
- Node.js
- curl
Kode contoh
Kontrol berpikir (thinking.type dan reasoning_effort)
ZHIPU/GLM-5.3 selalu berjalan dalam mode berpikir dan tidak mendukung penonaktifan berpikir. Tetapkan thinking.type ke enabled (atau tetapkan enable_thinking ke true), dan gunakan reasoning_effort untuk mengontrol kedalaman penalaran.
Parameter | Deskripsi | Nilai yang didukung |
|---|---|---|
| Mengontrol apakah berpikir diaktifkan. Nilai default-nya adalah |
|
| Mengontrol kedalaman penalaran model. Jika parameter ini tidak ditentukan, nilai default-nya adalah |
|
Penalaran historis yang jelas (clear_thinking)
Parameter clear_thinking mengontrol apakah reasoning_content (proses penalaran) dari putaran sebelumnya diteruskan ke model sebagai konteks dalam percakapan multi-putaran. Hanya model seri GLM yang mendukung parameter ini.
true: Mengabaikanreasoning_contentdari putaran sebelumnya dan hanya menggunakan konten non-penalaran, seperti teks yang terlihat, pemanggilan tool, dan hasil tool, sebagai konteks. Ini mengurangi panjang konteks dan biaya.false(default): Mempertahankanreasoning_contentdari putaran sebelumnya dan memberikannya ke model bersama konteks. Untuk mengaktifkan Preserved Thinking, Anda harus meneruskanreasoning_contenthistoris melalui pesan secara lengkap, tidak diubah, dan dalam urutan aslinya. Menghilangkan, memotong, menulis ulang, atau mengubah urutannya akan menurunkan efek atau mencegahnya berfungsi.
assistant membawa reasoning_content. Ketika clear_thinking=true, konten penalaran historis tidak dihitung dalam konteks, sehingga prompt_tokens lebih rendah dibandingkan dengan false (default). Nilai aktual tergantung pada panjang reasoning_content historis.
- Kompatibel OpenAI
Fitur lainnya
| Model | Percakapan multi-putaran | Function calling | Output terstruktur | Pencarian Internet | Penyelesaian awalan | Cache konteks | Kontrol upaya penalaran |
|---|---|---|---|---|---|---|---|
| ZHIPU/GLM-5.3 | Didukung | Didukung | Didukung | Tidak didukung | Didukung | Didukung | Didukungreasoning_effort |
| ZHIPU/GLM-5.2 | Didukung | Didukung | DidukungHanya mode non-berpikir | Tidak didukung | Didukung | Didukung | Didukungreasoning_effort |
- Jumlah minimum token yang di-cache adalah 512, dibandingkan dengan 1024 untuk Model Studio.
Nilai parameter default
Model | enable_thinking | temperature | top_p | top_k | repetition_penalty |
|---|---|---|---|---|---|
ZHIPU/GLM-5.3 | true (tidak dapat dinonaktifkan) | 1.0 | 0.95 | - | - |
ZHIPU/GLM-5.2 | true | 1.0 | 0.95 | - | - |
Daftar model dan penagihan
Model seri GLM adalah model penalaran hibrida dari Z.AI. Model ini dirancang untuk agen cerdas dan menawarkan dua mode: berpikir dan non-berpikir. ZHIPU/GLM-5.3 hanya mendukung mode berpikir.
Untuk informasi panjang konteks model dan harga, lihat Konsol Model StudioKonsol Model Studio.
Penagihan didasarkan pada token input dan output model.
Dalam mode berpikir, rantai pemikiran ditagih berdasarkan token output.
Kode kesalahan
Jika terjadi kesalahan, lihat Kode kesalahan untuk menyelesaikan masalah.
Berikut adalah kode kesalahan layanan yang unik untuk Z.AI. Kode kesalahan HTTP sama dengan kode kesalahan umum untuk Model Studio. Lihat tautan di atas.
Kategori kesalahan | Kode kesalahan | Pesan kesalahan |
|---|---|---|
Kesalahan dasar | 500 | Kesalahan internal |
Kesalahan autentikasi | 1000 | Autentikasi gagal |
1001 | Parameter Authentication tidak diterima dalam header. Autentikasi tidak dapat dilakukan. | |
1002 | Token Authentication tidak valid. Pastikan Token Authentication diteruskan dengan benar. | |
1003 | Token Authentication telah kedaluwarsa. Hasilkan ulang atau peroleh yang baru. | |
1004 | Verifikasi Token Authentication gagal. | |
1100 | Baca/tulis akun | |
Kesalahan akun | 1110 | Akun Anda tidak aktif. Periksa informasi akun Anda. |
1111 | Akun Anda tidak ada. | |
1112 | Akun Anda terkunci. Hubungi layanan pelanggan untuk membukanya. | |
1113 | Akun Anda memiliki saldo yang belum dibayar. Isi ulang akun Anda dan coba lagi. | |
1120 | Tidak dapat mengakses akun Anda. Coba lagi nanti. | |
1121 | Akun terkunci karena pelanggaran kebijakan. | |
Kesalahan pemanggilan API | 1200 | Kesalahan pemanggilan API |
1210 | Parameter pemanggilan API tidak valid. Periksa dokumentasi. | |
1211 | Model tidak ada. Periksa kode model. | |
1212 | Model saat ini tidak mendukung metode pemanggilan | |
1213 | Parameter | |
1214 | Parameter | |
1215 |
| |
1220 | Anda tidak memiliki izin untuk mengakses | |
1221 | API | |
1222 | API | |
1230 | Kesalahan proses pemanggilan API. | |
1231 | Anda sudah memiliki permintaan: | |
1234 | Kesalahan jaringan. ID Kesalahan: | |
1261 | Prompt terlalu panjang. | |
Kesalahan pemblokiran kebijakan API | 1300 | Pemanggilan API diblokir oleh kebijakan. |
1301 | Sistem mendeteksi konten yang berpotensi tidak aman atau sensitif dalam input atau output. Hindari menggunakan prompt yang dapat menghasilkan konten sensitif. Terima kasih atas kerja sama Anda. | |
1302 | Konkurensi untuk API ini terlalu tinggi. Kurangi konkurensi, atau hubungi layanan pelanggan untuk menaikkan batas. | |
1303 | Laju permintaan untuk API ini terlalu tinggi. Kurangi laju permintaan, atau hubungi layanan pelanggan untuk menaikkan batas. | |
1304 | Batas pemanggilan harian untuk API ini telah tercapai. Untuk menaikkan batas, hubungi layanan pelanggan. | |
1305 | Batas trafik untuk API ini telah tercapai. | |
1308 | Batas penggunaan | |
1309 | Langganan GLM Coding Plan Anda telah kedaluwarsa dan tidak tersedia. Untuk memulihkan layanan, perpanjang langganan Anda di https://bigmodel.cn/claude-code. | |
1310 | Batas penggunaan mingguan/bulanan telah tercapai. Batas Anda akan direset pada | |
1311 | Langganan Anda saat ini tidak mencakup akses ke | |
1312 | Model ini mengalami trafik tinggi. Coba lagi nanti, atau beralih ke model lain seperti | |
1313 | Penggunaan akun Anda melanggar kebijakan penggunaan wajar, dan laju permintaan Anda telah dibatasi. Untuk informasi lebih lanjut, lihat "Syarat dan Perjanjian - Perjanjian Langganan dan Perpanjangan Otomatis". Untuk memulihkan akses penuh, buka Pusat Pribadi > Ikhtisar Rencana Pemrograman dan ajukan permohonan pencabutan pembatasan. |