OneMux/Документация/Поддерживаемые протоколы

Поддерживаемые протоколы

OneMux поддерживает четыре формата протоколов: OpenAI, Anthropic, Gemini и Responses API. Разработчики могут выбирать оптимальный протокол с учётом особенностей модели и переключаться между ними без изменений существующего кода. На этой странице перечислены конечные точки, способы аутентификации и сценарии использования для каждого протокола.

Поддерживаемые протоколы

ПротоколКонечная точкаПоддерживаемые моделиСпособ аутентификации
Совместимый с OpenAI/v1/chat/completionsВсе моделиAuthorization: Bearer sk-xxx
Нативный Anthropic/v1/messagesСерия Claudex-api-key: sk-xxx
OpenAI Responses/v1/responsesСерия GPTAuthorization: Bearer sk-xxx
Нативный Gemini/v1beta/models/{model}:generateContentСерия GeminiAuthorization: Bearer sk-xxx

Зачем нужны разные протоколы?

  • Простой переход: не нужно менять существующий код, достаточно изменить Base URL
  • Полный доступ к нативным функциям: поддерживаются такие возможности, как Anthropic Prompt Caching, Claude Extended Thinking и контекст Gemini на 2M токенов
  • Максимальная производительность: Claude работает на 20-30% быстрее через протокол Anthropic, чем в формате OpenAI

Рекомендуемый способ использования

МодельРекомендуемый протоколПричина
Серия 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"}]
    }]
  }'