Anthropic SDK

Anthropic 公式 SDK は、Base URLをカスタマイズすることで、AGTCloud の Anthropic Messages 互換エンドポイントを呼び出すことができます。このチュートリアルでは、Python と TypeScript のインストール、非ストリーミング リクエスト、ストリーミング出力の例をそれぞれ示します。

このページでは、Messages 呼び出しのみを説明します。バッチ処理、ファイル、管理インターフェイス、およびその他の Anthropic プラットフォーム リソースの可用性は、AGTCloud API Referenceに従うものとします。

事前準備

開始前に、次の項目を確認してください。

• API Keys ページに AGTCloud API Keyを作成します。
• Anthropic Messages をサポートする完全なモデルIDを モデルマーケットプレイス からコピーします。
• Python 3.9+ または Node.js 20+ のサーバ動作環境を準備します。

このページでは、プレースホルダーとして MODEL_ID と your-api-key を使用します。実際の API Keyをブラウザのフロントエンド、モバイル インストール パッケージ、またはパブリック リポジトリに保存しないでください。

SDKをインストールする

python -m pip install anthropic

現在の安定版をインストールし、依存関係のロックファイルで使用するバージョンを固定することをお勧めします。

API Keyを設定する

API Keyをサーバー環境変数に保存します。

export AGTCLOUD_API_KEY="your-api-key"

サンプル コードは、AGTCLOUD_API_KEY から認証情報を読み取り、それらを Anthropic SDK に明示的に渡します。 SDK は、x-api-key ヘッダーを使用して認証情報を送信し、Messages リクエストで必要な anthropic-version ヘッダーを自動的に追加します。

クライアントを作成してリクエストを送信する

Base URL には、このページに表示されている API Origin を指定してください。/v1 や /v1/messages は追加しないでください。SDK がこのアドレスに Messages のパスを追加します。

import os

from anthropic import Anthropic

api_key = os.environ["AGTCLOUD_API_KEY"]

client = Anthropic(
    api_key=api_key,
    base_url="https://api.agtcloud.cn",
)

message = client.messages.create(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "自己紹介を3文でお願いします。",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

content の Anthropic Messages はContent Block配列です。テキストを読むときは、Content Blockのタイプを確認する必要があります。応答には常に 1 つのテキスト ブロックしか含まれないと想定しないでください。ツール呼び出し、画像、その他のコンテンツ タイプでは、異なるブロック構造が使用されます。

ストリーミング出力

import os

from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["AGTCLOUD_API_KEY"],
    base_url="https://api.agtcloud.cn",
)

with client.messages.stream(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "ベクトル検索とは何か簡単に説明してください。",
        }
    ],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

ストリーミング Messages は、SSE イベントを介して返されます。運用環境では、接続の中断、タイムアウト、スロットル、およびストリームの終了前に完全なコンテンツを受信できないことにも対処する必要があります。

よくある質問

次のステップ

• Anthropic Messages API Reference を参照して、Content Block、ツール呼び出し、拡張思考、および完全な応答フィールドについて学習してください。
• 既存の公式 SDK プロジェクトがある場合は、公式 SDK からの移行 を参照し、設定項目を一つずつ置き換えて回帰テストを実施してください。
• リクエストが失敗した場合は、認証と API Key、エラーとトラブルシューティングを参照してください。