ДокументацияНачало работыВведение

Введение

Что такое SoleAPI, базовый URL и обзор трёх диалектов API.

SoleAPI — это мультимодельный AI-шлюз: вызывайте Claude, GPT, Gemini, Grok, DeepSeek и другие ведущие модели через один API-ключ и один стабильный эндпоинт. Встроены умная маршрутизация и failover, потокенная тарификация, лимиты и квоты, маскирование данных запросов и статистика использования в реальном времени.

Базовый URL

Все запросы отправляются на один хост:

text
https://api.soleapi.com

В официальных SDK достаточно указать base_url на адрес выше — остальной код менять не нужно.

Три диалекта API

Шлюз одновременно поддерживает форматы всех трёх API, и один ключ работает со всеми. Выбирайте тот, который уже использует ваш код или инструменты:

ДиалектЭндпоинтЗаголовок авторизацииТипичные клиенты
Совместимый с OpenAIPOST /v1/responsesAuthorization: BearerOpenAI SDK · Codex
Совместимый с AnthropicPOST /v1/messagesx-api-keyAnthropic SDK · Claude Code
Совместимый с GeminiPOST /v1beta/models/{model}:generateContentx-goog-api-keyGoogle GenAI SDK

Шлюз при необходимости преобразует протоколы, поэтому большинство чат-моделей можно вызывать из любого диалекта. Если модель принимает только определённый протокол, вернётся понятная ошибка с объяснением (см. Ошибки).

Ключевые возможности

  • Умная маршрутизация и failover: автоматический выбор из нескольких источников с переключением и восстановлением через circuit breaker при сбоях.
  • Потокенная тарификация: вход и выход (включая кэш и reasoning-токены) тарифицируются отдельно; баланс и все операции видны в журнале.
  • Лимиты и квоты: ограничения RPM/конкурентности, лимиты расходов на ключ с периодическим сбросом и списки разрешённых IP.
  • Маскирование данных и модерация: настраиваемые фильтры приватности маскируют чувствительные поля перед пересылкой, модерация блокирует рискованные запросы.
  • Наблюдаемость в реальном времени: тренды на дашборде, статистика по ключам и детальные журналы по каждому запросу.

Дальнейшие шаги