OneMux/Documentación/Compatibilidad de protocolos

Compatibilidad de protocolos

OneMux admite simultáneamente los cuatro formatos de protocolo: OpenAI, Anthropic, Gemini y Responses API. Los desarrolladores pueden elegir el protocolo óptimo según las características del modelo y cambiar entre ellos sin modificar el código existente. En esta página se enumeran los endpoints, los métodos de autenticación y los casos de uso de cada protocolo.

Protocolos compatibles

ProtocoloEndpointModelos aplicablesMétodo de autenticación
Compatible con OpenAI/v1/chat/completionsTodos los modelosAuthorization: Bearer sk-xxx
Anthropic nativo/v1/messagesSerie Claudex-api-key: sk-xxx
OpenAI Responses/v1/responsesSerie GPTAuthorization: Bearer sk-xxx
Gemini nativo/v1beta/models/{model}:generateContentSerie GeminiAuthorization: Bearer sk-xxx

¿Por qué existen varios protocolos?

  • Bajo coste de migración: no es necesario modificar el código existente, solo cambiar la Base URL
  • Todas las funciones nativas: admite características como Anthropic Prompt Caching, Claude Extended Thinking y el contexto de 2M de Gemini
  • Máximo rendimiento: Claude es un 20-30% más rápido con el protocolo Anthropic que con el formato OpenAI

Forma de uso recomendada

ModeloProtocolo recomendadoMotivo
Serie ClaudeAnthropic nativoAdmite Prompt Caching, reduciendo los costes un 90%
Serie GPTCompatible con OpenAIFormato estándar, máxima compatibilidad
Serie GeminiGemini nativoAdmite un contexto de 2M para procesar documentos muy extensos

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

Formato Anthropic nativo (recomendado para 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"}]
  }'

Formato Gemini nativo

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