LiteLLM + APIMaster.ai

LiteLLM は、統一された LLM SDK とローカルの Proxy サーバーを提供します。APIMaster.ai は OpenAI 互換の API を公開しています — openai/<model id> 形式を使用し、api_base を設定します。

最初に API Key を取得してください。マーケットプレイス から正確な model id をコピーします。

Base URL:

https://apimaster.ai/v1

LiteLLM model name format:

openai/<APIMaster model id>

例: openai/claude-sonnet-4-6。

---

前提条件

1. Python 3.10+ (3.11+ 推奨)。
2. コンソール から APIMaster API Key を取得。
3. マーケットプレイス から対象の model id を取得。

---

ステップ 1 — LiteLLM のインストール

SDK のみ：

pip install litellm

Proxy サポート付き：

pip install "litellm[proxy]"

---

ステップ 2 — 最小限の Python SDK テスト

minimal_apimaster_test.py を作成：

import litellm

API_KEY = "your APIMaster key"

response = litellm.completion(
    model="openai/claude-sonnet-4-6",
    api_base="https://apimaster.ai/v1",
    api_key=API_KEY,
    messages=[
        {"role": "user", "content": "Say hi in one short sentence."},
    ],
    max_tokens=64,
)

print(response.choices[0].message.content)

または サンプルスクリプトをダウンロード。

python minimal_apimaster_test.py

---

ステップ 3 — LiteLLM Proxy の設定

config.apimaster.yaml を作成：

model_list:
  - model_name: apimaster-claude-sonnet
    litellm_params:
      model: openai/claude-sonnet-4-6
      api_base: https://apimaster.ai/v1
      api_key: os.environ/APIMASTER_API_KEY

general_settings:
  master_key: sk-local-test

または サンプル設定をダウンロード。

Key	目的
APIMASTER_API_KEY	実際の APIMaster キー — LiteLLM が上流で使用します
master_key	ローカル Proxy アクセスキー — クライアントが使用します

---

ステップ 4 — LiteLLM Proxy の起動

export APIMASTER_API_KEY="your APIMaster key"
litellm --config config.apimaster.yaml --port 4000

litellm が PATH にない場合：

python -m litellm --config config.apimaster.yaml --port 4000

---

ステップ 5 — ローカル Proxy のテスト

curl http://localhost:4000/v1/chat/completions \
  -H "Authorization: Bearer sk-local-test" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "apimaster-claude-sonnet",
    "messages": [{"role": "user", "content": "Say hi in one short sentence."}],
    "max_tokens": 64
  }'

---

ステップ 6 — 複数モデル

model_list:
  - model_name: apimaster-claude-sonnet
    litellm_params:
      model: openai/claude-sonnet-4-6
      api_base: https://apimaster.ai/v1
      api_key: os.environ/APIMASTER_API_KEY

  - model_name: apimaster-gpt
    litellm_params:
      model: openai/gpt-5.4
      api_base: https://apimaster.ai/v1
      api_key: os.environ/APIMASTER_API_KEY

general_settings:
  master_key: sk-local-test

クライアントは openai/gpt-5.4 ではなく apimaster-gpt を呼び出します。

---

トラブルシューティング

401 無効なトークン

キーが間違っているか無効です。確認：

curl https://apimaster.ai/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

モデルが見つからない

マーケットプレイスの model id を openai/ プレフィックス付きで使用：

model: openai/claude-sonnet-4-6

api_base が間違っている

/v1 を含める必要があります：

api_base: https://apimaster.ai/v1

---

推奨される確認手順

1. Python SDK の最小スクリプト — APIMaster キーとモデルを検証します。
2. LiteLLM Proxy を起動します。
3. OpenAI 互換の JSON でローカル Proxy を呼び出します。

---

チェックリスト

• litellm をインストール済み（Proxy の場合は litellm[proxy]）
• SDK: openai/<model id> + api_base=https://apimaster.ai/v1
• Proxy: APIMASTER_API_KEY と master_key を別々に設定
• SDK または Proxy テストが応答を返す

---

関連情報

• プラットフォーム概要
• OpenAI 互換ガイド
• LangChain ガイド
• LiteLLM ドキュメント