APIMaster.ai
APIMaster.ai ドキュメント
Quick startAPIMaster.aiMarketplace

LangChain + APIMaster.ai

公式のOpenAIクイックスタートキーの代わりに、LangChainでAPIMaster.aiのOpenAI互換APIを使用します。

LangChain は、LLMアプリケーション向けの人気フレームワークです。APIMaster.aiはOpenAI互換のAPIを公開しており、model_provider="openai"を設定し、base_urlをAPIMasterに向けます。

まずAPIキーを取得してください。マーケットプレイスから正確なモデルIDをコピーします（例：gpt-5.4、claude-sonnet-4-6）。

前提条件

  1. Python 3.10以上（3.11以上推奨）。
  2. コンソールからのAPIMaster APIキー。
  3. マーケットプレイスからのターゲットモデルID。

ステップ1 — 依存関係のインストール

pip install langchain langchain-openai httpx

ステップ2 — サンプルファイルの作成

apimaster_quickstart.pyを作成します：

import httpx

from langchain.agents import create_agent
from langchain.chat_models import init_chat_model


APIMASTER_API_KEY = "your APIMaster.ai key"
APIMASTER_BASE_URL = "https://apimaster.ai/v1"
MODEL_NAME = "gpt-5.4"


def get_weather(city: str) -> str:
    """指定された都市の天気を取得します。"""
    return f"{city}はいつも晴れです！"


def main() -> None:
    model = init_chat_model(
        MODEL_NAME,
        model_provider="openai",
        api_key=APIMASTER_API_KEY,
        base_url=APIMASTER_BASE_URL,
        http_client=httpx.Client(trust_env=False, timeout=60),
        timeout=60,
    )

    agent = create_agent(
        model=model,
        tools=[get_weather],
        system_prompt="あなたは役立つアシスタントです",
    )

    result = agent.invoke(
        {"messages": [{"role": "user", "content": "サンフランシスコの天気はどうですか？"}]}
    )

    print(result["messages"][-1].content_blocks)


if __name__ == "__main__":
    main()

サンプルスクリプトをダウンロードして、実行前にキーを貼り付けることもできます。

ステップ3 — 実行

python apimaster_quickstart.py

成功すると、次のような出力が表示されます：

[{'type': 'text', 'text': 'サンフランシスコはいつも晴れです！'}]

エージェントがget_weatherツールを呼び出し、最終的な応答を返します。

主要な設定

APIMaster OpenAI互換ベースURL：

https://apimaster.ai/v1

コアなLangChain設定：

model = init_chat_model(
    "gpt-5.4",
    model_provider="openai",
    api_key=APIMASTER_API_KEY,
    base_url="https://apimaster.ai/v1",
)
パラメータ 値
model_provider "openai"（OpenAI互換プロトコル）
base_url https://apimaster.ai/v1
モデル名 マーケットプレイスのモデルID

GPTの例：MODEL_NAME = "gpt-5.4" Claudeの例：MODEL_NAME = "claude-sonnet-4-6"

プロキシの問題

ローカルでHTTP_PROXY / HTTPS_PROXYが設定されている場合、SSLまたは接続エラーが発生する可能性があります。以下を渡してください：

http_client=httpx.Client(trust_env=False, timeout=60)

これにより、httpxがシステムプロキシ環境変数を取得するのを防ぎます。ローカルでの簡単なテストに便利です。本番環境では必要に応じてプロキシを明示的に設定してください。

より安全なキー管理

実際のプロジェクトでは、キーをハードコーディングする代わりに環境変数を使用してください：

import os

APIMASTER_API_KEY = os.environ["APIMASTER_API_KEY"]
APIMASTER_BASE_URL = "https://apimaster.ai/v1"

export APIMASTER_API_KEY="your key"
python apimaster_quickstart.py

Windows PowerShell：

$env:APIMASTER_API_KEY="your key"
python apimaster_quickstart.py

トラブルシューティング

症状 修正方法
401 / 無効なAPIキー キーが完全で、コンソールで有効になっていることを確認
404 / モデルが見つからない MODEL_NAMEがマーケットプレイスのモデルIDと完全に一致している必要があります
SSL / タイムアウト trust_env=Falseを試す；ファイアウォール/プロキシを確認
ModuleNotFoundError pip install langchain langchain-openai httpxを実行

チェックリスト

  • langchain、langchain-openai、httpxをインストール済み
  • base_url = https://apimaster.ai/v1
  • マーケットプレイスからのMODEL_NAME
  • APIキーが設定されている（コードまたは環境変数）
  • apimaster_quickstart.pyが実行され、エージェントの出力が表示される

関連情報