APIMaster.ai
Tài liệu APIMaster.ai
Quick startAPIMaster.aiMarketplace

LangChain + APIMaster.ai

Sử dụng API tương thích OpenAI của APIMaster.ai trong LangChain thay vì khóa khởi tạo nhanh chính thức của OpenAI.

LangChain là một framework phổ biến cho các ứng dụng LLM. APIMaster.ai cung cấp một API tương thích với OpenAI — hãy đặt model_provider="openai" và trỏ base_url đến APIMaster.

Hãy lấy Khóa API trước. Sao chép chính xác model id từ thị trường (ví dụ: gpt-5.4, claude-sonnet-4-6).

Điều kiện tiên quyết

  1. Python 3.10+ (khuyến nghị 3.11+).
  2. Một Khóa API APIMaster từ bảng điều khiển.
  3. Một model id mục tiêu từ thị trường.

Bước 1 — Cài đặt các phụ thuộc

pip install langchain langchain-openai httpx

Bước 2 — Tạo tệp mẫu

Tạo 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:
    """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()

Bạn cũng có thể tải xuống tệp mẫu và dán khóa của bạn trước khi chạy.

Bước 3 — Chạy

python apimaster_quickstart.py

Nếu thành công, bạn sẽ thấy đầu ra tương tự như:

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

Agent gọi công cụ get_weather và trả về phản hồi cuối cùng.

Các cài đặt chính

URL cơ sở tương thích OpenAI của APIMaster:

https://apimaster.ai/v1

Cấu hình LangChain cốt lõi:

model = init_chat_model(
    "gpt-5.4",
    model_provider="openai",
    api_key=APIMASTER_API_KEY,
    base_url="https://apimaster.ai/v1",
)
Tham số Giá trị
model_provider "openai" (giao thức tương thích OpenAI)
base_url https://apimaster.ai/v1
Tên model model id từ Thị trường

Ví dụ GPT: MODEL_NAME = "gpt-5.4"
Ví dụ Claude: MODEL_NAME = "claude-sonnet-4-6"

Vấn đề proxy

Nếu HTTP_PROXY / HTTPS_PROXY được thiết lập trên máy cục bộ, bạn có thể gặp lỗi SSL hoặc kết nối. Hãy truyền:

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

Điều này ngăn httpx lấy các biến môi trường proxy hệ thống — hữu ích cho các kiểm tra nhanh cục bộ. Cấu hình proxy một cách rõ ràng trong môi trường sản xuất nếu cần.

Xử lý khóa an toàn hơn

Đối với các dự án thực tế, hãy sử dụng biến môi trường thay vì mã hóa cứng khóa:

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

Khắc phục sự cố

Triệu chứng Cách khắc phục
401 / Khóa API không hợp lệ Xác minh khóa còn đầy đủ và được kích hoạt trong bảng điều khiển
404 / model không tìm thấy MODEL_NAME phải khớp chính xác với model id trên thị trường
SSL / timeout Thử trust_env=False; kiểm tra tường lửa/proxy
ModuleNotFoundError Chạy pip install langchain langchain-openai httpx

Danh sách kiểm tra

  • Đã cài đặt langchain, langchain-openai, httpx
  • base_url = https://apimaster.ai/v1
  • MODEL_NAME từ thị trường
  • Đã đặt Khóa API (trong mã hoặc biến môi trường)
  • apimaster_quickstart.py chạy và xuất ra kết quả từ agent

Xem thêm