Для разработчиков

OpenAI-совместимый API для нейросетей

Сохраните знакомый клиент и формат запросов. Для подключения ElysiumAI достаточно заменить адрес API, указать свой ключ и выбрать модель из живого каталога.

01 · Client

Оставьте OpenAI SDK

Python, JavaScript и другие клиенты с настройкой custom base URL продолжают работать в привычном формате.

02 · Gateway

Замените три значения

Укажите новый base URL, ключ ElysiumAI и идентификатор нужной модели. Остальная структура вызова сохраняется.

03 · Models

Сравнивайте модели

Выбирайте GPT, Claude, Gemini, DeepSeek, Grok, Qwen и другие семейства через один каталог моделей.

Миграция

Первый запрос через существующий клиент

Создайте API-ключ в кабинете, выберите доступную модель и подставьте её ID. Перед внедрением проверьте streaming, tool calls и параметры конкретной модели в документации.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_ELYSIUM_API_KEY",
    base_url="https://elysiumai.garden/v1",
)

response = client.chat.completions.create(
    model="model-family/model-id",
    messages=[{"role": "user", "content": "Привет!"}],
    stream=True,
)

API formats

Не только Chat Completions

Публичный gateway поддерживает OpenAI Chat Completions и Responses, Anthropic Messages, Gemini generateContent, embeddings, генерацию и редактирование изображений. Поддержка зависит от выбранной модели и указана в каталоге.

GET /v1/models возвращает общие ID для автоматического выбора модели. Чтобы получить доступные варианты и их тарифы, вызовите GET /v1/model-options с API-ключом. Передавайте поле id выбранного варианта в запросе генерации. Тариф может быть за токены, запрос, изображение, секунду видео или медиа-операцию; для медиа точную оценку даёт POST /v1/media/quote, а для динамического тарифа фиксированная цена заранее не указана.

/v1/chat/completions/v1/responses/v1/messages/v1/embeddings/v1/images/generations/v1/images/edits/v1beta/models/*/v1/models/v1/model-options

Когда gateway подходит

  • Нужно сравнивать модели разных провайдеров в одном приложении.
  • Приложение уже использует OpenAI SDK и custom base URL.
  • Нужны единые API-ключи, журнал запросов и контроль расходов.
  • Важно быстро менять модель без отдельной интеграции каждого провайдера.

Когда лучше прямой API

  • Нужен эксклюзивный provider-native функционал без слоя совместимости.
  • Требуется отдельный корпоративный договор именно с разработчиком модели.
  • Инфраструктура обязана полностью исключать сторонний gateway.
  • Проект зависит от параметров, которых нет в совместимом формате.

FAQ

Частые вопросы

Что означает OpenAI-совместимый API?

Это API, который принимает привычные запросы OpenAI Chat Completions и возвращает ответы в совместимом формате. Для перехода обычно достаточно заменить base URL, API-ключ и идентификатор модели.

Нужно ли менять OpenAI SDK?

Нет. Можно оставить официальный OpenAI SDK для Python или JavaScript и указать адрес ElysiumAI в настройке base URL.

Можно ли использовать модели не только OpenAI?

Да. В каталоге ElysiumAI есть семейства GPT, Claude, Gemini, DeepSeek, Grok, Qwen и другие. Совместимость конкретной модели и эндпоинта указана в публичном каталоге.

Поддерживается ли потоковая передача ответа?

Да. Для совместимых моделей можно передать stream: true и обрабатывать SSE-поток так же, как в существующем OpenAI-клиенте.

Где посмотреть актуальные модели и цены?

Общие ID моделей доступны через GET /v1/models. Эндпоинт GET /v1/model-options показывает доступные вызываемые варианты и их розничные цены. Поле id из ответа можно передать в запросе генерации.

Нужна единая точка входа для нескольких моделей?

Разберите архитектуру gateway или сразу переходите к документации.