OneMux/문서/프로토콜 지원

프로토콜 지원

OneMux는 OpenAI, Anthropic, Gemini 및 Responses API의 네 가지 프로토콜 형식을 모두 지원합니다. 개발자는 모델 특성에 맞는 최적의 프로토콜을 선택할 수 있으며, 기존 코드를 수정하지 않고도 전환할 수 있습니다. 이 페이지에서는 각 프로토콜의 엔드포인트, 인증 방식 및 사용 사례를 안내합니다.

지원되는 프로토콜

프로토콜엔드포인트지원 모델인증 방식
OpenAI 호환/v1/chat/completions모든 모델Authorization: Bearer sk-xxx
Anthropic 네이티브/v1/messagesClaude 시리즈x-api-key: sk-xxx
OpenAI Responses/v1/responsesGPT 시리즈Authorization: Bearer sk-xxx
Gemini 네이티브/v1beta/models/{model}:generateContentGemini 시리즈Authorization: Bearer sk-xxx

프로토콜이 여러 개인 이유

  • 낮은 마이그레이션 비용: 기존 코드를 수정할 필요 없이 Base URL만 변경하면 됩니다.
  • 네이티브 기능 완벽 지원: Anthropic Prompt Caching, Claude Extended Thinking, Gemini 2M 컨텍스트 등의 기능을 지원합니다.
  • 최적의 성능: Claude는 OpenAI 형식보다 Anthropic 프로토콜을 사용할 때 20-30% 더 빠릅니다.

권장 사용 방식

모델권장 프로토콜이유
Claude 시리즈Anthropic 네이티브Prompt Caching을 지원해 비용을 90% 절감합니다.
GPT 시리즈OpenAI 호환표준 형식으로 호환성이 가장 뛰어납니다.
Gemini 시리즈Gemini 네이티브2M 컨텍스트를 지원해 매우 긴 문서를 처리할 수 있습니다.

OpenAI 호환 형식

curl https://api.onemux.net/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Anthropic 네이티브 형식 (Claude 사용 권장)

curl https://api.onemux.net/v1/messages \
  -H "x-api-key: sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Gemini 네이티브 형식

curl https://api.onemux.net/v1beta/models/gemini-4-argon:generateContent \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "Hello"}]
    }]
  }'