APIMaster.ai
APIMaster.ai 使用文件
快速開始APIMaster 官網模型廣場

LangChain + APIMaster.ai

在 LangChain 中使用 APIMaster.ai 提供的 OpenAI 相容 API，取代官方 OpenAI 快速入門金鑰。

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"It's always sunny in {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': "It's always sunny in San Francisco!"}]

代理程式呼叫了 get_weather 工具並回傳最終回覆。

關鍵設定

APIMaster OpenAI 相容的 base 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"

Proxy 問題

如果本機設定了 HTTP_PROXY / HTTPS_PROXY，可能遇到 SSL 或連線錯誤。請傳入：

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

這樣可以防止 httpx 讀取系統 proxy 環境變數 — 對於快速本機測試很有用。在正式環境中請明確設定 proxy。

更安全地處理金鑰

正式專案建議使用環境變數而非在程式碼中寫死金鑰：

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 並顯示代理程式輸出

另請參閱