GLM API: クライアントを3行で切り替え

前提条件: キーの取得

コードを書く前にAPI キーが必要です。このサイトのAPI キーを取得ページで、メールアドレスとパスワードでサインアップしてください。開始するには電話番号やクレジットカードは必要ありません。登録すると、7日間有効な$0.50の無料トライアルクレジットが付与されます。または、暗号通貨（USDTまたはUSDC）でチャージすることもできます。キーはサインアップ直後に表示されます。古いキーを取り消すためにいつでも再生成できるため、安全に保管してください。

このキーは当glm apiエンドポイントへのすべてのリクエストを認証します。プロンプトは学習に使用されず、キーは単一のアカウントに紐付きます。より高い処理量が必要な場合は、期限切れにならない前払いクレジットを購入できます。

ベースURLとキーの設定

OpenAIの代替として当サービスを利用するには、SDKをベースURLにポイントする必要があります。これが唯一必要なインフラストラクチャの変更です。ベースURLはhttps://api.glmapikey.com/v1です。また、サインアップ時に受け取った値を認証ヘッダーまたはSDKクライアントキーに設定する必要があります。

公式のPythonおよびNode SDKを含むほとんどのOpenAI互換クライアントでは、ベースURLの上書きが可能です。これにより、基盤となるモデルを切り替えながら既存のアプリケーションロジックを維持できます。認証エラーを避けるため、リクエスト送信前にキーが正しく設定されていることを確認してください。

最初のチャット完了リクエストを行う

テキストを生成するには/v1/chat/completionsにPOSTリクエストを送信します。当モデルはuserやassistantなどのロールを持つ標準的なメッセージ構造を受け入れます。指定する必要があるモデルIDはuncensoredです。これは、当社のGPUでホストされているオープンウェイトモデルをトリガーし、法的な成人向け利用に対してコンテンツ拒否なしで回答するようにチューニングされています。

レスポンスには生成されたテキストを含むJSONが含まれます。401エラーが発生した場合はキーを確認してください。402エラーが表示された場合は、前払いクレジットが枯渇しています。$10からチャージを開始できます。なお、このエンドポイントでは埋め込みベクトル、画像、ファインチューニングはサポートされていません。

Python SDKの使用

公式のOpenAI Pythonライブラリは当APIと直接連携します。キーと特定のベースURLを使用してクライアントを初期化します。このアプローチは、構造化JSONレスポンスが必要なバックエンドサービスやスクリプトに最適です。クライアントはシリアライズとリトライロジックを自動的に処理します。

特定のエンドポイントに確実にアクセスするために、モデル名uncensoredを指定してください。コンテキストウィンドウはプロンプトと完了の合計で最大100,000トークンをサポートします。これにより、8 MBのリクエストボディ制限内に収まる限り、切り捨てなしで大量の入力データを処理できます。

Node SDKの使用

JavaScriptおよびTypeScriptアプリケーションの場合、openai NPMパッケージは互換性があります。Pythonの例と同じベースURLとキーでクライアントを設定します。これにより、無検閲テキスト生成が必要なサーバーサイドレンダリングやAPIエンドポイントを有効化できます。正しく構成されていれば、SDKはデータを効率的にストリーミングします。

このSDKでは関数呼び出しがサポートされています。リクエストに関数スキーマを定義すると、モデルはスキーマに一致する構造化JSON出力を返します。これにより、生のテキストを解析することなく、外部データソースやアクションをアプリケーションフローに簡単に統合できます。

ストリーミングレスポンスの有効化

リクエストにstream: trueを設定して、サーバー送信イベント（SSE）を受け取ってください。これにより、生成されたテキストをユーザーに表示でき、体感レイテンシーが向上します。APIはテキストのチャンクを返すため、クライアント側で連結または逐次レンダリングする必要があります。

ストリーミングはPythonおよびNode SDKの両方でサポートされています。これは、即時フィードバックを期待するチャットインターフェースで特に有用です。各チャンクにはレスポンスの一部が含まれています。モデルは完了するかコンテキストウィンドウの制限に達するまで生成を続けます。ストリーミングで関数呼び出しを使用する場合は、クライアントが部分的なJSON構造を正しく処理することを確認してください。

制限、エラー、モデル

当APIはキーあたり1分あたり300リクエストのレート制限を適用します。これを超えると、429エラーが発生します。最大リクエストボディサイズは8 MBです。モデルの検出にはGET /v1/modelsエンドポイントを使用してください。これにはuncensoredモデルIDを含む利用可能なモデルのリストが返されます。

一般的なエラーには、無効なキーによる401と、クレジット不足による402があります。クレジットは期限切れになりませんが、無料トライアルクレジットは7日間有効です。SLAや認証は提供していません。このモデルは未成年者を含む性的コンテンツをブロックしますが、それ以外は無検閲です。これらの制限を考慮して、リトライロジックとユーザー通知を設計してください。

cURL

Copycurl https://api.glmapikey.com/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.glmapikey.com/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapikey.com/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);

ストリーミング

Copystream = 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)