APIMaster.ai
APIMaster.ai 문서
Quick startAPIMaster.aiMarketplace

LangChain + APIMaster.ai

LangChain에서 공식 OpenAI Quickstart 키 대신 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:
    """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()

실행 전에 샘플 스크립트를 다운로드하여 키를 붙여넣을 수도 있습니다.

3단계 — 실행

python apimaster_quickstart.py

성공하면 다음과 유사한 출력이 표시됩니다:

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

에이전트가 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 실행 및 에이전트 출력 확인

참고 문서