コンテンツへスキップ
GLM5.org
チャットを開く
POST /v1/chat/completions

開発者ガイド

GLM-5 API：最初のリクエストから本番環境への導入まで

すべてのGLM-5モデルはOpenAI互換のChat Completions APIを通じて提供されます。Z.ai独自のプラットフォーム、またはOpenRouter経由で呼び出すことができます。本ガイドでは料金、モデルID、推論制御、画像入力、すぐに使えるコード例を含め、両方の方法を網羅しています。
コードへジャンプ無料チャットで試す
ノートPCとサーバーラックの間を行き交うAPIリクエストを描いたブループリント風のイラスト

§ 012つの利用ルート

GLM-5の呼び出し方法

Z.aiのプラットフォーム

GLMの開発元であるZ.aiは、自社のAPIを運用しています。標準のエンドポイントは https://api.z.ai/api/paas/v4/chat/completions で、OpenAI Chat Completionsプロトコルに準拠しているため、base URLを変更するだけでOpenAI公式SDKが動作します。また、Z.aiのドキュメントにはコーディング用エンドポイント（https://api.z.ai/api/coding/paas/v4）、Responses形式のエンドポイント（https://api.z.ai/api/v1）、それらの形式を前提とするツール向けのAnthropic互換エンドポイント（https://api.z.ai/api/anthropic）も記載されています。

Z.ai上でのモデルコードは短く、glm-5.3、glm-5.3-flash、glm-5.3-flashx となっています。思考機能（Thinking）は "thinking": {"type": "enabled"} で有効化し、その深さは reasoning_effort で設定します。利用にはZ.aiのアカウントとAPIキーが必要です。最新の料金はZ.ai公式の料金ページをご確認ください。

OpenRouter

OpenRouterはアグリゲーターです。1つのキーと1つのエンドポイント（https://openrouter.ai/api/v1/chat/completions）で、他社のモデルとともにすべてのGLM-5モデルにアクセスできます。モデルIDには z-ai/glm-5.3 や z-ai/glm-5.3-flash などのベンダープレフィックスが付き、推論の制御は {"effort": "low"} のような単一の reasoning オブジェクトで行います。

下表の料金はOpenRouterのものです。当サイトの無料チャットもOpenRouterを利用して稼働しているため、チャットでの挙動がそのままAPIの挙動の目安になります。

  • 開発元独自のプラットフォーム、コーディング専用エンドポイント、またはAnthropic互換アクセスを必要とする場合は、Z.aiを選択してください。
  • 多数のモデルファミリーの請求を一本化し、モデル間を簡単に切り替えたい場合はOpenRouterをお選びください。
  • どちらを選んでも、コードはベースURLとモデル名を変えるだけで、同じOpenAI形式のリクエストを使用できます。

§ 02料金

OpenRouterでのGLM-5 API料金

100万トークンあたりのUSD価格と、一般的なチャット1,000ターンあたりの推定料金です。モデルをクリックすると詳細ガイドが表示されます。

OpenRouterでのGLM-5 API料金
モデルモデルIDコンテキスト入力 / 1M出力 / 1M1,000回のチャット*
GLM-5z-ai/glm-5205K$1$3.20$3.74
GLM-5-Turboz-ai/glm-5-turbo203K$1.20$4$4.60
GLM-5V-Turboz-ai/glm-5v-turbo203K$1.20$4$4.60
GLM-5.1z-ai/glm-5.1205K$1.40$4.40$5.18
GLM-5.2z-ai/glm-5.21.05M$0.0341$7$4.95
GLM-5.3z-ai/glm-5.31.05M$0.079$1.40$1.10
GLM-5.3 Flashz-ai/glm-5.3-flash1.05M$0.0052$0.1985$0.15
GLM-5.3 FlashXz-ai/glm-5.3-flashx1.05M$0.37$1.25$1.43
GLM-5.3 Primez-ai/glm-5.3-prime1M$2.80$8.80$10

*入力1,500トークン、出力700トークンからなるチャット1,000ターンの試算です。価格は執筆時点のOpenRouterモデル一覧に基づきます。reasoningトークンは出力として課金されます。

§ 03コード

すぐにコピーして使えるリクエスト

APIキーは環境変数に設定してください。クライアント側のコードや公開リポジトリには絶対に含めないでください。

OpenRouter

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-ai/glm-5.3",
    "messages": [
      {"role": "system", "content": "You are a concise senior engineer."},
      {"role": "user", "content": "Explain idempotency keys in two paragraphs."}
    ],
    "reasoning": {"effort": "low"},
    "max_tokens": 1024,
    "stream": false
  }'

Z.aiプラットフォーム

curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "Summarise the CAP theorem."}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "low"
  }'

Z.aiでは短縮モデルコード（glm-5.3、glm-5.3-flash）と独立したthinkingスイッチを使用します。最新のパラメータと制限事項についてはZ.aiのドキュメントをご確認ください。

§ 04詳細

重要なパラメータ

推論も回答の一部です

GLM-5.3は回答前に必ず推論を行います。その推論量は調整可能です。モデルカードには3段階のreasoning_effortレベル（low、high、max）が記載されており、指定しない場合のデフォルトはmaxとなります。チャットやシンプルなツール呼び出しでは、明示的にlow effortを設定してください。推論トークンは出力として課金されるため、回答が高速化し、コストも抑えられます。

OpenRouter経由でストリーミングする場合、推論内容はdelta.reasoningに、最終テキストはdelta.contentに含まれて届きます。前者は折りたたみ可能な「思考中」パネルとして表示するか非表示にし、会話履歴には再ペーストしないでください。

GLM-5.3 Flashへの画像送信

GLM-5.3 Flash、GLM-5.3 FlashX、GLM-5V-Turboは画像入力に対応しています。ユーザーメッセージをパートの配列として送信してください。テキストパートと、urlに公開HTTPSアドレスまたはbase64データURL（例: data:image/jpeg;base64,…）を指定したimage_urlパートを含めます。GLM-5.3およびGLM-5.3 Primeはテキスト専用のため、画像リクエストはFlashにルーティングしてください。

大きな写真は送信前にリサイズしてください。長辺を1,024ピクセル程度に抑えることでリクエストサイズを小さく保て、ドキュメント、グラフ、スクリーンショットに関するほとんどの質問に十分対応できます。

コンテキストと出力の上限

GLM-5.2、GLM-5.3、GLM-5.3 FlashはOpenRouter上で1,048,576トークンのコンテキストと、最大943,718出力トークンに対応しています。ただし、すべての呼び出しで上限まで使い切るべきではありません。これらのモデルでは入力トークンは安価ですが、長い出力はコストがかかるため、max_tokensをご自身のUIで表示可能な範囲に制限してください。

エージェント運用の場合は、システムプロンプトを固定し、会話を書き直すのではなく末尾に追加していくようにしてください。プロンプトキャッシュに対応しているプロバイダーであれば、前回の処理を再利用できます。

  • ユーザーが待機する処理にはstream: trueを使用してください。
  • 429、502、503レスポンスは短いバックオフを挟んでリトライしてください。
  • 利用コストを把握するため、最後のチャンクから使用量（usage）をログに記録してください。

§ 05よくある質問

GLM-5 APIに関する質問

Q01GLM-5 APIはOpenAI SDKと互換性がありますか？

はい。Z.aiのエンドポイントとOpenRouterはどちらもOpenAIスタイルのchat completionsリクエストを受け付けます。SDKのベースURLをプロバイダーに向け、GLMのモデル名を指定するだけで利用できます。

Q02呼び出しコストが最も安いGLM-5モデルはどれですか？

GLM-5.3 Flashです。OpenRouterでは入力100万トークンあたり$0.0052、出力100万トークンあたり$0.1985で利用でき、画像や動画の読み取りにも対応しています。

Q03GLM-5.3のモデルIDを教えてください。

OpenRouterでは、z-ai/glm-5.3、z-ai/glm-5.3-flash、z-ai/glm-5.3-flashx、z-ai/glm-5.3-primeが利用可能です。Z.aiのプラットフォームでは、glm-5.3、glm-5.3-flash、glm-5.3-flashxが提供されています。

Q04推論（思考プロセス）をオフにすることはできますか？

GLM-5.3はZ.aiのプラットフォーム上では常に推論を行います。当サイトの無料チャットのデフォルト設定のように、推論の強度（reasoning effort）を低く指定することで、推論を短く抑えることは可能です。

Q05無料のGLM-5 APIはありますか？

当サイトでは公開APIを提供していません。まずは当サイトの無料ウェブチャットでGLM-5.3やGLM-5.3 Flashをお試しいただき、プログラムからのアクセスが必要になった場合はZ.aiまたはOpenRouterをご利用ください。

今すぐ試す

GLM-5.3 に実践的な質問をしてみましょう。

アカウント登録・クレジットカード・インストールは不要。質問を入力するだけで、GLM-5.3 Flash がわずか数秒で回答します。難問には GLM-5.3 に切り替えて対応可能です。

無料チャットを開くすべての方にチャットをご利用いただくため、1日の無料利用制限が適用されます。