OpenAI 호환 API 가이드

OpenAI API 형식은 대규모 언어 모델의 표준 인터페이스가 되었습니다. "OpenAI 호환 API"는 동일한 요청 형식(/v1/chat/completions)을 받고 동일한 구조로 응답을 반환하므로 코드 변경 없이 모델을 교체할 수 있습니다.

APIMaster.ai는 Claude, GPT, DeepSeek, Gemini 등에 대한 OpenAI 호환 엔드포인트를 제공합니다.

OpenAI 호환 API란 무엇인가요?

다음 엔드포인트를 구현하는 모든 API는 "OpenAI 호환"입니다.

엔드포인트	메서드	목적
/v1/chat/completions	POST	응답 생성
/v1/models	GET	사용 가능한 모델 목록
/v1/embeddings	POST	임베딩 생성

요청/응답 스키마가 OpenAI와 동일하므로 OpenAI를 지원하는 모든 도구(LangChain, LiteLLM, Dify, open-webui 등)가 자동으로 작동합니다.

APIMaster의 OpenAI 호환 엔드포인트 사용 방법

기본 URL: https://apimaster.ai/v1

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_APIMASTER_KEY",
    base_url="https://apimaster.ai/v1",
)

# Claude 호출
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "OpenAI 호환 API에서 안녕!"}],
)

# DeepSeek 호출
response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "안녕!"}],
)

# GPT 호출
response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "안녕!"}],
)

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

하나의 클라이언트, 세 개의 제공자, 코드 변경 없음.

인기 프레임워크와 통합

LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4-6",
    openai_api_key="YOUR_APIMASTER_KEY",
    openai_api_base="https://apimaster.ai/v1",
)

response = llm.invoke("LangChain은 무엇에 사용되나요?")
print(response.content)

LiteLLM

import litellm

response = litellm.completion(
    model="openai/claude-sonnet-4-6",
    api_key="YOUR_APIMASTER_KEY",
    api_base="https://apimaster.ai/v1",
    messages=[{"role": "user", "content": "안녕!"}],
)
print(response.choices[0].message.content)

Dify

Dify의 모델 제공자 설정에서:

• 제공자: OpenAI 호환
• API 키: APIMaster 키
• API 기본 URL: https://apimaster.ai/v1
• 모델 이름: claude-sonnet-4-6 또는 gpt-5.4

Open WebUI

docker run -d \
  -e OPENAI_API_KEY="YOUR_APIMASTER_KEY" \
  -e OPENAI_API_BASE_URL="https://apimaster.ai/v1" \
  -p 3000:8080 \
  ghcr.io/open-webui/open-webui

Cursor / VS Code AI 확장

사용자 정의 OpenAI 기본 URL을 https://apimaster.ai/v1로 설정하고 APIMaster 키를 사용하세요. 사용 가능한 목록에서 원하는 모델을 선택합니다.

APIMaster OpenAI 호환 엔드포인트에서 사용 가능한 모델

Claude (Anthropic)

• claude-sonnet-4-6 — 최고의 가성비
• claude-opus-4-8 — 가장 뛰어난 성능
• claude-haiku-4-5 — 가장 빠르고 저렴함

GPT (OpenAI)

• gpt-5.5 — 고성능 GPT-5 시리즈 모델
• gpt-5.4 — 균형 잡힌 GPT-5 시리즈 모델

DeepSeek

• deepseek-v4-flash — 강력한 코딩, 매우 저렴함
• deepseek-v4-pro — 추론

Gemini (Google)

• gemini-2.5-pro — 긴 컨텍스트

전체 목록은 모델 페이지에서 확인하세요.

런타임 모델 전환

MODELS = ["claude-sonnet-4-6", "gpt-5.4", "deepseek-v4-flash"]

def compare_models(prompt):
    client = OpenAI(api_key="YOUR_KEY", base_url="https://apimaster.ai/v1")
    for model in MODELS:
        resp = client.chat.completions.create(
            model=model,
            messages=[{"role": "user", "content": prompt}],
            max_tokens=200,
        )
        print(f"\n=== {model} ===")
        print(resp.choices[0].message.content)

compare_models("재귀를 한 문단으로 설명해주세요.")

OpenAI에서 OpenAI 호환 API로 마이그레이션

정확히 두 줄만 변경하세요:

# 이전
from openai import OpenAI
client = OpenAI(api_key="sk-...")

# 이후 (APIMaster)
from openai import OpenAI
client = OpenAI(
    api_key="YOUR_APIMASTER_KEY",   # ← 변경됨
    base_url="https://apimaster.ai/v1",         # ← 추가됨
)

다른 모든 것(모델, 스트리밍, 함수 호출, 임베딩)은 그대로 유지됩니다.

OpenAI 호환 API에 APIMaster를 선택해야 하는 이유

• 하나의 엔드포인트에서 모든 주요 제공자: 각 제공자마다 별도의 키가 필요 없음
• 지문 확인: 실제로 호출 중인 모델을 알 수 있음
• 일부 모델 할인된 가격

자주 묻는 질문

OpenAI 호환 API란 무엇인가요? OpenAI의 Chat Completions 엔드포인트 형식(POST /v1/chat/completions)과 일치하는 API입니다. LangChain, LlamaIndex, PromptFlow 등 OpenAI용으로 구축된 모든 라이브러리나 도구가 코드 변경 없이 OpenAI 호환 API와 작동합니다.

APIMaster의 OpenAI 호환 API는 어떤 모델을 지원하나요? GPT-5 시리즈 모델, GPT-4o, Claude Sonnet 4.6, Claude Opus 4.8, DeepSeek V4 Flash/Pro, Gemini 2.5 Pro 등이 있습니다. 전체 모델 목록을 확인하세요.

OpenAI에서 OpenAI 호환 API로 어떻게 전환하나요? api_key를 APIMaster 키로 변경하고 base_url을 https://apimaster.ai/v1로 변경하세요. 모든 모델 호출, 스트리밍, 도구 사용, 응답 파싱이 변경 없이 작동합니다.

APIMaster의 API는 스트리밍과 함수 호출을 지원하나요? 예 — 둘 다 완전히 지원되며 공식 OpenAI API와 동일한 인터페이스를 사용합니다.

여러 모델 제공자에 대해 하나의 API 키를 사용할 수 있나요? 예 — 이것이 APIMaster의 주요 장점입니다. 하나의 키와 하나의 엔드포인트로 model 매개변수만 변경하여 GPT, Claude, DeepSeek, Gemini를 호출할 수 있습니다.

API 액세스 — GPT, Claude 및 DeepSeek용 OpenAI 호환 키 하나 → · 모델 가격 확인 →