OneMux/Dokumentation/Protokollunterstützung

Protokollunterstützung

OneMux unterstützt die vier Protokollformate OpenAI, Anthropic, Gemini und Responses API. Entwickler können je nach Modelleigenschaften das optimale Protokoll wählen und wechseln, ohne bestehenden Code ändern zu müssen. Auf dieser Seite sind die Endpunkte, Authentifizierungsmethoden und Anwendungsfälle der einzelnen Protokolle aufgeführt.

Unterstützte Protokolle

ProtokollEndpunktGeeignete ModelleAuthentifizierungsmethode
OpenAI-kompatibel/v1/chat/completionsAlle ModelleAuthorization: Bearer sk-xxx
Natives Anthropic/v1/messagesClaude-Modellex-api-key: sk-xxx
OpenAI Responses/v1/responsesGPT-ModelleAuthorization: Bearer sk-xxx
Natives Gemini/v1beta/models/{model}:generateContentGemini-ModelleAuthorization: Bearer sk-xxx

Warum gibt es mehrere Protokolle?

  • Geringer Migrationsaufwand: Der bestehende Code muss nicht geändert werden; es genügt, die Base URL anzupassen
  • Volle Unterstützung nativer Funktionen: Unterstützt Funktionen wie Anthropic Prompt Caching, Claude Extended Thinking und den 2M-Kontext von Gemini
  • Optimale Leistung: Claude ist über das Anthropic-Protokoll 20-30% schneller als im OpenAI-Format

Empfohlene Verwendung

ModellEmpfohlenes ProtokollGrund
Claude-ModelleNatives AnthropicUnterstützt Prompt Caching und senkt die Kosten um 90%
GPT-ModelleOpenAI-kompatibelStandardformat mit der besten Kompatibilität
Gemini-ModelleNatives GeminiUnterstützt einen 2M-Kontext und verarbeitet sehr lange Dokumente

OpenAI-kompatibles Format

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"}]
  }'

Natives Anthropic-Format (für Claude empfohlen)

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"}]
  }'

Natives Gemini-Format

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"}]
    }]
  }'