OneMux/Documentação/Protocolos compatíveis

Protocolos compatíveis

O OneMux oferece suporte simultâneo aos formatos de protocolo OpenAI, Anthropic, Gemini e Responses API. Os desenvolvedores podem escolher o protocolo mais adequado às características do modelo e alternar entre eles sem modificar o código existente. Esta página lista os endpoints, os métodos de autenticação e os casos de uso de cada protocolo.

Protocolos compatíveis

Protocolo	Endpoint	Modelos compatíveis	Método de autenticação
Compatível com OpenAI	/v1/chat/completions	Todos os modelos	Authorization: Bearer sk-xxx
Anthropic nativo	/v1/messages	Modelos Claude	x-api-key: sk-xxx
OpenAI Responses	/v1/responses	Modelos GPT	Authorization: Bearer sk-xxx
Gemini nativo	/v1beta/models/{model}:generateContent	Modelos Gemini	Authorization: Bearer sk-xxx

Por que há vários protocolos?

Baixo custo de migração: não é necessário alterar o código existente, basta mudar a Base URL
Recursos nativos completos: oferece suporte a recursos como Anthropic Prompt Caching, Claude Extended Thinking e contexto de 2M do Gemini
Desempenho ideal: Claude é 20-30% mais rápido com o protocolo Anthropic do que no formato OpenAI

Formas de uso recomendadas

Modelo	Protocolo recomendado	Motivo
Modelos Claude	Anthropic nativo	Oferece suporte a Prompt Caching, reduzindo os custos em 90%
Modelos GPT	Compatível com OpenAI	Formato padrão, com a melhor compatibilidade
Modelos Gemini	Gemini nativo	Oferece suporte a contexto de 2M para processar documentos muito longos

Formato compatível com 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"}]
    }]
  }'