本ドキュメントでは、Alibaba Cloud Model Studio で Z.AI モデル推論サービスを呼び出す方法について説明します。
サービスの有効化
- Model Studio コンソール に移動し、ZHIPU/GLM を検索して、Z.AI GLM-series テキストモデルカードを見つけ、「今すぐ有効化」をクリックします。
- ダイアログボックスで、有効化と承認を確認します。
クイックスタート
ZHIPU/GLM-5.3 は GLM シリーズのモデルであり、1M のコンテキストをサポートしています。以下のコードを実行して、思考モードで ZHIPU/GLM-5.3 モデルを素早く呼び出してください。
API キーを取得 し、API キーを環境変数として設定 している必要があります。SDK を使用してモデルを呼び出す場合は、SDK をインストール する必要もあります。
- OpenAI 互換性
enable_thinking パラメータは標準的な OpenAI のパラメータではありません。OpenAI Python SDK では、extra_body に渡します。Node.js SDK では、トップレベルのパラメータとして渡します。- Python
- Node.js
- HTTP
サンプルコード
レスポンス
ストリーミングツール呼び出し
ZHIPU/GLM-5.3、ZHIPU/GLM-5.2 の各モデルは tool_stream パラメータをサポートしています。このパラメータはブール値で、デフォルトは false であり、stream が true の場合にのみ機能します。有効にすると、Function calling の tool_call パラメータの arguments がストリームとして増分的に返されます。
stream パラメータと tool_stream パラメータは、以下のように連動します。
stream | tool_stream | tool_call |
|---|---|---|
true | true |
|
true | false(デフォルト) |
|
false | true/false |
|
- OpenAI 互換
- Python
- Node.js
- curl
サンプルコード
思考制御(thinking.type および reasoning_effort)
ZHIPU/GLM-5.3 は常に思考モードで実行され、思考の無効化はサポートされていません。thinking.type を enabled に設定したままにする(または enable_thinking を true に設定したままにする)ことで、reasoning_effort を使用して推論の深さを制御してください。
パラメーター | 説明 | サポートされている値 |
|---|---|---|
| 思考を有効にするかどうかを制御します。デフォルト値は |
|
| モデルの推論の深さを制御します。このパラメータが指定されていない場合、デフォルト値は |
|
過去の推論内容のクリア(clear_thinking)
clear_thinking パラメータは、マルチターン会話において以前のターンの reasoning_content(推論プロセス)をコンテキストとしてモデルに渡すかどうかを制御します。このパラメータをサポートするのは GLM シリーズのモデルのみです。
true:以前のターンのreasoning_contentを無視し、表示されるテキスト、ツール呼び出し、ツール結果などの非推論コンテンツのみをコンテキストとして使用します。これにより、コンテキストの長さとコストが削減されます。false(デフォルト):以前のターンのreasoning_contentを保持し、コンテキストとともにモデルに提供します。Preserved Thinking を有効にするには、過去のreasoning_contentをメッセージ内で完全に、変更せず、元の順序のまま渡す必要があります。省略、切り捨て、書き換え、または並べ替えを行うと、効果が低下するか、有効にならなくなります。
assistant メッセージには reasoning_content が含まれています。clear_thinking=true の場合、過去の推論内容はコンテキストにカウントされないため、prompt_tokens はデフォルトである false の場合よりも少なくなります。実際の値は過去の reasoning_content の長さに依存します。
- OpenAI 互換
その他の機能
| モデル | マルチターン会話 | Function calling | 構造化出力 | インターネット検索 | プレフィックス補完 | コンテキストキャッシュ | 推論強度の制御 |
|---|---|---|---|---|---|---|---|
| ZHIPU/GLM-5.3 | サポート済み | サポート済み | サポート済み | 未サポート | サポート済み | サポート済み | サポート済みreasoning_effort |
| ZHIPU/GLM-5.2 | サポート済み | サポート済み | サポート済み非思考モードのみ | 未サポート | サポート済み | サポート済み | サポート済みreasoning_effort |
- キャッシュされるトークンの最小数は 512 で、Model Studio の 1024 と異なります。
デフォルトパラメータ値
モデル | enable_thinking | temperature | top_p | top_k | repetition_penalty |
|---|---|---|---|---|---|
ZHIPU/GLM-5.3 | true(無効化不可) | 1.0 | 0.95 | - | - |
ZHIPU/GLM-5.2 | true | 1.0 | 0.95 | - | - |
モデル一覧と課金
GLM シリーズのモデルは Z.AI のハイブリッド推論モデルです。これらはインテリジェントエージェント向けに設計されており、思考モードと非思考モードの2つのモードを提供します。ZHIPU/GLM-5.3 は思考モードのみをサポートしています。
モデルのコンテキスト長と価格情報については、Model Studio コンソールModel Studio コンソール を参照してください。
課金はモデルの入力トークンと出力トークンに基づきます。
思考モードでは、思考連鎖は出力トークンに基づいて課金されます。
エラーコード
エラーが発生した場合は、エラーコードを参照して問題を解決してください。
以下は Z.AI 固有のサービスエラーコードです。HTTP エラーコードは Model Studio の一般的なエラーコードと同じです。上記のリンクを参照してください。
エラーカテゴリ | エラーコード | エラーメッセージ |
|---|---|---|
基本エラー | 500 | 内部エラー |
認証エラー | 1000 | 認証に失敗しました |
1001 | ヘッダーで Authentication パラメータが受信されませんでした。認証を実行できません。 | |
1002 | 認証トークンが無効です。認証トークンが正しく渡されていることを確認してください。 | |
1003 | 認証トークンの有効期限が切れています。再生成するか、新しいトークンを取得してください。 | |
1004 | 認証トークンの検証に失敗しました。 | |
1100 | アカウント読み取り/書き込み | |
アカウントエラー | 1110 | アカウントが非アクティブです。アカウント情報を確認してください。 |
1111 | アカウントが存在しません。 | |
1112 | アカウントがロックされています。ロックを解除するにはカスタマーサービスにお問い合わせください。 | |
1113 | アカウントの残高が不足しています。アカウントに入金してから再試行してください。 | |
1120 | アカウントにアクセスできません。後でもう一度お試しください。 | |
1121 | ポリシー違反によりアカウントがロックされました。 | |
API呼び出しエラー | 1200 | API呼び出しエラー |
1210 | API呼び出しパラメータが無効です。ドキュメントを確認してください。 | |
1211 | モデルが存在しません。モデルコードを確認してください。 | |
1212 | 現在のモデルは | |
1213 |
| |
1214 |
| |
1215 |
| |
1220 |
| |
1221 | API | |
1222 | API | |
1230 | API呼び出しプロセスエラー。 | |
1231 | すでにリクエストが存在します: | |
1234 | ネットワークエラー。エラー ID: | |
1261 | プロンプトが長すぎます。 | |
APIポリシーブロックエラー | 1300 | API呼び出しがポリシーによってブロックされました。 |
1301 | システムが入力または出力に潜在的に安全でない、あるいは機微なコンテンツを検出しました。機微なコンテンツを生成する可能性のあるプロンプトの使用は避けてください。ご協力ありがとうございます。 | |
1302 | この API の同時実行数が高すぎます。同時実行数を減らすか、カスタマーサービスに連絡して上限を引き上げてください。 | |
1303 | この API のリクエストレートが高すぎます。リクエストレートを下げるか、カスタマーサービスに連絡して上限を引き上げてください。 | |
1304 | この API の日次呼び出し上限に達しました。上限を引き上げるには、カスタマーサービスにお問い合わせください。 | |
1305 | このAPIのトラフィック制限に達しました。 | |
1308 |
| |
1309 | お客様の GLM Coding Plan は有効期限切れのため利用できません。サービスを復旧するには、https://bigmodel.cn/claude-code でプランを更新してください。 | |
1310 | 週間または月間の使用量上限に達しました。上限は | |
1311 | 現在のご契約プランには | |
1312 | このモデルはトラフィックが集中しています。後でもう一度お試しいただくか、 | |
1313 | アカウントの使用状況がフェアユースポリシーに違反しており、リクエストレートが制限されています。詳細については、「利用規約 - サブスクリプションおよび自動更新契約」を参照してください。フルアクセスを復旧するには、パーソナルセンター > プログラミングプラン概要 に移動し、制限解除を申請してください。 |