사용자 가이드

API 프로토콜

LMU AI는 세 가지 인바운드 프로토콜을 지원합니다 — Anthropic, OpenAI 호환, Gemini 네이티브. 하나의 표로 올바른 Base URL과 엔드포인트를 선택하고 오류를 방지하세요.

LMU AI는 세 가지 인바운드 프로토콜을 지원합니다: Anthropic, OpenAI 호환, Gemini 네이티브 v1beta. 모든 엔드포인트는 여러분의 LMU AI sk- API 키를 사용하며, 실제로 호출할 수 있는 모델은 키가 속한 그룹에 의해 결정됩니다.

먼저 명확히 구분해야 할 두 가지

  • "어떤 프로토콜인가" 는 클라이언트, SDK, 사용 사례에 의해 결정됩니다. Anthropic SDK는 /v1/messages를 사용하고, OpenAI SDK는 /v1/chat/completions 또는 /v1/responses를 사용하며, Gemini 네이티브 이미지 호출은 /v1beta/models/{model}:generateContent를 사용합니다.
  • "어떤 모델을 호출할 수 있는가" 는 여러분 API 키의 그룹(구독 / 충전 플랜 뒤에 있는 업스트림 계정)에 의해 결정되며, 이는 인바운드 프로토콜과는 별개의 차원입니다.

다시 말해: 잘못된 프로토콜은 곧바로 401 / 404를 발생시키고, 올바른 프로토콜이라도 그룹 범위를 벗어난 모델을 사용하면 모델 사용 불가 오류를 반환합니다.

가장 흔한 오류는 잘못된 프로토콜에서 비롯됩니다

  • Anthropic 프로토콜 Base URL에는 /v1 접미사가 없습니다
  • OpenAI 프로토콜 SDK Base URL에는 보통 /v1 접미사가 있습니다
  • Gemini 네이티브 프로토콜 은 호스트로 https://api.lmuai.com을 사용하고 전체 /v1beta/... 경로를 호출합니다

이를 잘못 설정하면 400 / 401 / 404가 발생합니다. 도구를 구성하거나 코드를 작성하기 전에, 클라이언트가 어떤 프로토콜을 기대하는지 확인하세요.


한눈에 프로토콜 선택하기

프로토콜Base URL대표 도구
Anthropic 프로토콜https://api.lmuai.comClaude Code (CLI / 데스크톱 / VS Code 확장), 공식 anthropic SDK, Cherry Studio, Claude / 중국어 모델을 사용하는 Kilo Code, 모든 Anthropic 호환 클라이언트
OpenAI 호환https://api.lmuai.com/v1Codex CLI, Codex App, Cursor / Cline / Roo Code / OpenCode, 공식 openai SDK, GPT를 사용하는 VS Code 확장, 모든 OpenAI 호환 클라이언트
Gemini 네이티브 v1betahttps://api.lmuai.comGemini 네이티브 SDK / HTTP 클라이언트, Gemini 텍스트-이미지 및 이미지-이미지, 모델 목록 및 generateContent

세 프로토콜 모두 sk-로 시작하는 LMU AI 키를 사용합니다:

  • Anthropic 프로토콜: Authorization: Bearer <YOUR_API_KEY> 또는 x-api-key: <YOUR_API_KEY>
  • OpenAI 호환: Authorization: Bearer <YOUR_API_KEY>
  • Gemini 네이티브: x-goog-api-key: <YOUR_API_KEY> 권장, Bearer도 허용됨

Anthropic 프로토콜

Base URL: https://api.lmuai.com (/v1 없음)

엔드포인트:

  • POST /v1/messages — 메시지 대화
  • POST /v1/messages/count_tokens — 토큰 카운팅
  • GET /v1/models — 사용 가능한 모델 목록

Python SDK 예시:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.lmuai.com",
    api_key="sk-xxxxxxxx",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.content[0].text)

curl 예시:

curl -X POST https://api.lmuai.com/v1/messages \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"Hello"}]
  }'

왜 SDK base_url에는 /v1이 없고 curl에는 /v1이 있나요?

Anthropic 공식 SDK의 base_url 관례는 /v1을 생략하는 것이며, SDK가 내부적으로 /v1/messages 같은 경로를 추가합니다. curl을 직접 작성할 때는 전체 경로 /v1/messages를 씁니다. 둘 다 같은 엔드포인트를 가리킵니다.


OpenAI 프로토콜

Base URL: https://api.lmuai.com/v1 (/v1 있음)

엔드포인트:

  • POST /chat/completions — 표준 Chat Completions API
  • POST /responses — OpenAI Responses API (/responses/{id} 하위 경로 포함)
  • POST /images/generations, POST /images/edits — 이미지 생성 / 편집

Python SDK 예시:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lmuai.com/v1",
    api_key="sk-xxxxxxxx",
)

resp = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

curl 예시:

curl -X POST https://api.lmuai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role":"user","content":"Hello"}]
  }'

Gemini 네이티브 프로토콜

Base URL: https://api.lmuai.com

주요 엔드포인트:

  • GET /v1beta/models — Gemini 네이티브 모델 목록
  • GET /v1beta/models/{model} — 특정 모델 조회
  • POST /v1beta/models/{model}:generateContent — 텍스트 생성, 텍스트-이미지, 이미지-이미지
  • POST /v1beta/models/{model}:streamGenerateContent?alt=sse — 스트리밍 생성

인증:

x-goog-api-key: YOUR_API_KEY

최소한의 텍스트-이미지 예시:

curl --request POST \
  'https://api.lmuai.com/v1beta/models/gemini-3.1-flash-image:generateContent' \
  -H 'x-goog-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "an orange cat wearing an astronaut helmet"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
    }
  }'

Gemini 이미지 엔드포인트는 /v1/chat/completions가 아닙니다

Gemini 이미지 모델은 네이티브 generateContent를 사용합니다. 전체 텍스트-이미지, 이미지-이미지, 1K / 2K / 4K, Base64 파싱 세부 사항은 Gemini Image API를 참조하세요.

GPT 이미지 모델은 GPT Image API, Grok 이미지 모델은 Grok Image API를 참조하세요. 대규모 오프라인 Gemini 작업은 Gemini Batch Image API를 참조하세요.


프로토콜과 사용 가능한 모델은 서로 다른 두 가지입니다

여러분의 키가 호출할 수 있는 모델은 그룹에 마운트된 업스트림 계정에 의해 전적으로 결정되며, 어떤 프로토콜로 호출하든 무관합니다:

그룹의 업스트림실제로 호출할 수 있는 모델
OpenAI 계정만GPT 시리즈만
Claude 계정만Claude 시리즈만 (OpenAI 프로토콜로 호출하더라도 백엔드가 프로토콜을 변환하지만, 모델 범위는 변하지 않음)
중국어 모델 업스트림만 (예: GLM / Kimi)해당 중국어 모델만
백엔드에 구성된 모델 라우팅 (다중 업스트림 그룹)모델 이름별로 서로 다른 업스트림으로 라우팅되며 브랜드를 넘나들 수 있음 — 정확한 범위는 그룹 구성에 따라 다름

따라서:

  • Anthropic, OpenAI 호환, Gemini 네이티브 프로토콜 중 선택하는 것은 인바운드 요청 형식을 결정하며, 실제 모델 범위는 여전히 API 키의 그룹에 의해 결정됩니다.
  • 현재 키가 호출할 수 있는 모델을 확인하려면, API Keys 상세 페이지 또는 콘솔의 Available Models 페이지에서 그룹의 모델 목록을 확인하세요.

Claude Max 그룹에 관하여

Claude Max 그룹은 Anthropic 프로토콜만 지원합니다

Claude Max 그룹은 Claude Code 전용이므로, Anthropic 프로토콜 (https://api.lmuai.com) 만 사용할 수 있습니다.

Claude Max 플랜 그룹의 키를 사용하는 경우:

  • ✅ Claude Code (CLI / 데스크톱 / VS Code 확장)에서 작동합니다
  • ❌ Codex CLI, Cursor, Cherry Studio, 또는 OpenAI 프로토콜을 사용하는 모든 도구에서는 사용할 수 없습니다
  • https://api.lmuai.com/v1로 입력할 수 없습니다

OpenAI 프로토콜 도구를 사용하려면, 종량제 / 일반 구독 그룹의 키로 전환하세요 (정확한 사용 가능 모델은 구매한 플랜 그룹에 따라 다릅니다).


문제 해결

증상일반적인 원인조치
401 UnauthorizedBase URL이 잘못된 프로토콜 사용 / 키 오타 / IDE 미재시작Base URL이 도구의 프로토콜과 일치하는지 확인; IDE를 재시작하여 구성 다시 로드
404 Not FoundOpenAI 프로토콜 URL에 /v1 누락, Anthropic URL에 /v1을 잘못 포함, 또는 Gemini 경로가 /v1beta/models/...를 사용하지 않음위 표를 기준으로 Base URL과 전체 엔드포인트를 다시 확인
모델 사용 불가 / No available accounts그룹 범위를 벗어난 모델을 호출함 (예: Claude Max 그룹으로 GPT 호출)Available Models 페이지에서 그룹에 실제로 포함된 모델을 확인하거나, 대상 모델을 포함하는 그룹으로 전환
429 Too Many Requests일일 할당량 소진FAQ 참조

추가 문제 해결은 FAQ를 참조하세요.


다음 단계

프로토콜과 Base URL을 올바르게 설정했다면, 사용하려는 도구를 선택하세요:

마지막 업데이트:

이 페이지의 목차