RouterShiftRouterShift
Обзор моделейТарифыДокументация
RouterShiftRouterShiftRouterShift. Корпоративная ИИ-инфраструктура.
Обзор моделейСтатусДокументацияУсловияКонфиденциальностьDPAПрозрачность

Документация API

Справочник API

Обзор RouterShift API

RouterShift предоставляет интерфейсы, совместимые с OpenAI, Anthropic и Gemini, для моделей, активных для вашего ключа. За протокольной границей применяются маршрутизация, переход к резервным вариантам, тарификация и подтверждающие записи аудита.

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

  • OpenAI-совместимый API — готовая замена для любого клиента OpenAI SDK
  • Настраиваемые стратегии маршрутизации: по весам, по кругу, по задержке и с резервными вариантами
  • Встроенный автоматический выключатель и ограничение запросов для защиты приложения
  • Семантическое кэширование для снижения задержки и затрат на повторяющиеся запросы
  • Комплексное логирование, мониторинг и аналитика расходов
  • Поддержка нескольких провайдеров с автоматическим фоллбэком при недоступности провайдера

Базовый URL для OpenAI

Все запросы API используют следующий базовый URL. API полностью совместим с клиентскими библиотеками OpenAI — достаточно изменить базовый URL и использовать API-ключ RouterShift.

https://api.routershift.com/v1

Anthropic-совместимый базовый URL

Для Anthropic SDK или Claude Code. Обратите внимание: без суффикса /v1 — SDK добавляет /v1/messages автоматически.

https://api.routershift.com

Совместимость с несколькими протоколами

Клиенты OpenAI, Anthropic и Gemini обычно подключаются заменой базового URL и учётных данных. Поддерживаемые поля и маршруты определяются текущим контрактом OpenAPI; расширения поставщиков не переносятся автоматически.

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

GET /v1/models является источником сведений о моделях, доступных вашему ключу. Доступность также зависит от продукта, состояния маршрутов, разрешений, баланса, региона и приватного доступа.

Получение помощи

Если вы столкнулись с проблемами или у вас есть вопросы, обратитесь к разделам ниже. По вопросам биллинга обращайтесь в поддержку через консоль. Для актуального статуса посетите страницу статуса.

Полный список эндпоинтов

Таблица представляет собой удобный указатель публичного контура данных. Машиночитаемый контракт доступен по /api/openapi.yaml, интерактивная справка — по /api/docs. Ограничения ключа продолжают действовать.

GET/v1/version

Версия и совместимость API плоскости данных

GET/v1/models

Список моделей

POST/v1/chat/completions

Чат-завершения (совместимо с OpenAI)

POST/v1/messages

Messages API (совместимо с Anthropic)

POST/v1/models/gemini/:model/generateContent

Генерация содержимого Gemini

POST/v1/models/gemini/:model/streamGenerateContent

Потоковая генерация контента Gemini

POST/v1/embeddings

Текстовые эмбеддинги

POST/v1/rerank

Реранкинг

POST/v1/chat/completions/estimate

Предварительная оценка токенов и стоимости

POST/v1/images/generations

Генерация изображений

POST/v1/audio/transcriptions

Транскрибация аудио

POST/v1/audio/speech

Синтез речи

POST/v1/tts

Расширенный синтез речи

POST/v1/transcriptions

Расширенная транскрибация

POST/v1/midjourney/imagine

Генерация изображений Midjourney

POST/v1/suno/generate

Генерация музыки Suno

POST/v1/video/generations

Задача генерации видео

GET/v1/video/tasks/:task_id

Статус задачи генерации видео

POST/v1/chat/completions/async

Асинхронная задача — отправка

GET/v1/chat/completions/async/:task_id

Асинхронная задача — проверка статуса

GET/v1/chat/completions/async/:task_id/result

Асинхронная задача — получение результата

POST/v1/batch

Пакетная обработка

GET/v1/batch/:batch_id

Статус пакетной задачи

GET/v1/batch/:batch_id/results

Загрузка результатов пакетной задачи

POST/v1/batch/:batch_id/cancel

Отмена пакетной задачи

POST/v1/mcp/

Шлюз инструментов MCP JSON-RPC

GET/v1/mcp/sse

SSE-транспорт MCP

POST/v1/a2a/

Шлюз A2A JSON-RPC

GET/v1/a2a/sse

Поток событий SSE A2A

МетодПутьОписание
GET/v1/versionВерсия и совместимость API плоскости данных
GET/v1/modelsСписок моделей
POST/v1/chat/completionsЧат-завершения (совместимо с OpenAI)
POST/v1/messagesMessages API (совместимо с Anthropic)
POST/v1/models/gemini/:model/generateContentГенерация содержимого Gemini
POST/v1/models/gemini/:model/streamGenerateContentПотоковая генерация контента Gemini
POST/v1/embeddingsТекстовые эмбеддинги
POST/v1/rerankРеранкинг
POST/v1/chat/completions/estimateПредварительная оценка токенов и стоимости
POST/v1/images/generationsГенерация изображений
POST/v1/audio/transcriptionsТранскрибация аудио
POST/v1/audio/speechСинтез речи
POST/v1/ttsРасширенный синтез речи
POST/v1/transcriptionsРасширенная транскрибация
POST/v1/midjourney/imagineГенерация изображений Midjourney
POST/v1/suno/generateГенерация музыки Suno
POST/v1/video/generationsЗадача генерации видео
GET/v1/video/tasks/:task_idСтатус задачи генерации видео
POST/v1/chat/completions/asyncАсинхронная задача — отправка
GET/v1/chat/completions/async/:task_idАсинхронная задача — проверка статуса
GET/v1/chat/completions/async/:task_id/resultАсинхронная задача — получение результата
POST/v1/batchПакетная обработка
GET/v1/batch/:batch_idСтатус пакетной задачи
GET/v1/batch/:batch_id/resultsЗагрузка результатов пакетной задачи
POST/v1/batch/:batch_id/cancelОтмена пакетной задачи
POST/v1/mcp/Шлюз инструментов MCP JSON-RPC
GET/v1/mcp/sseSSE-транспорт MCP
POST/v1/a2a/Шлюз A2A JSON-RPC
GET/v1/a2a/sseПоток событий SSE A2A

Соответствие протоколов

RouterShift совместим с несколькими API-протоколами. В таблице ниже указаны базовый URL и конфигурация SDK для каждого.

Совместимо с OpenAI

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer / x-api-key

Совместимо с Anthropic

https://api.routershift.com

Models: <available-model-code>

x-api-key: sk-xxx

Нативный Gemini

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer

Базовый URLПример параметра моделиЗаголовок авторизации
https://api.routershift.com/v1
Стандартный SDK OpenAI — достаточно изменить base_url
<available-model-code>Authorization: Bearer / x-api-key
https://api.routershift.com
Стандартный SDK Anthropic — достаточно изменить base_url
<available-model-code>x-api-key: sk-xxx
https://api.routershift.com/v1
Нативный формат Gemini, прямой вызов generateContent
<available-model-code>Authorization: Bearer

Единая аутентификация

Все эндпоинты используют одну аутентификацию. Оба формата заголовков работают одинаково:

Формат совместимый с OpenAI

Authorization: Bearer sk-xxx

Формат совместимый с Anthropic

x-api-key: sk-xxx