APIMaster.ai
APIMaster.ai 使用文档
English快速开始APIMaster 官网模型广场

LangChain 配置 APIMaster.ai

在 LangChain 中使用 APIMaster.ai 的 OpenAI 兼容接口，替换官方 quickstart 里的 OpenAI Key。

LangChain 是常用的 LLM 应用开发框架。APIMaster.ai 提供 OpenAI 兼容 接口，在 LangChain 里将 model_provider 设为 openai 并指定 base_url 即可接入。

开始前请 获取 API Key。模型名称须从 模型广场 复制 model id（如 gpt-5.4、claude-sonnet-4-6），与 API 参数完全一致。

前置条件

  1. Python 3.10+（建议 3.11 或更高）。
  2. 已从 APIMaster 控制台 复制 API Key。
  3. 已在 模型广场 选好目标模型并复制 model 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 = "填入你的 APIMaster.ai Key"
APIMASTER_BASE_URL = "https://apimaster.ai/v1"
MODEL_NAME = "gpt-5.4"


def get_weather(city: str) -> str:
    """Get weather for a given city."""
    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="You are a helpful assistant",
    )

    result = agent.invoke(
        {"messages": [{"role": "user", "content": "What's the weather in San Francisco?"}]}
    )

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


if __name__ == "__main__":
    main()

也可 下载示例脚本 到本地后填入 Key 再运行。

第 3 步：运行

python apimaster_quickstart.py

调用成功时，终端会输出类似：

[{'type': 'text', 'text': "It's always sunny in San Francisco!"}]

Agent 会调用 get_weather 工具并返回最终回复。

关键配置说明

APIMaster.ai 的 OpenAI 兼容地址为：

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
第一个位置参数 / MODEL_NAME 模型广场 上的 model id

GPT 系列示例：

MODEL_NAME = "gpt-5.4"

Claude 系列示例：

MODEL_NAME = "claude-sonnet-4-6"

关于代理问题

若本机配置了 HTTP_PROXY / HTTPS_PROXY，可能遇到 SSL 或连接错误。可在 init_chat_model 中传入：

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

这会让 httpx 不自动读取系统代理环境变量，适合本地快速测试。生产环境请按实际网络策略配置代理。

更安全的写法

教程为方便测试将 Key 写在代码里。实际项目建议使用环境变量：

import os

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

启动前设置：

export APIMASTER_API_KEY="你的 key"
python apimaster_quickstart.py

Windows PowerShell：

$env:APIMASTER_API_KEY="你的 key"
python apimaster_quickstart.py

常见问题

现象 处理
401 / Invalid API Key 检查 Key 是否完整、是否已在控制台启用
404 / model not found MODEL_NAME 与广场 model 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 Key 已配置（代码或环境变量）
  • 运行 apimaster_quickstart.py 能正常输出 Agent 回复

相关链接