Миграция с OpenAI API на ModelSwitch — это процесс перехода на единый API-шлюз, который занимает менее 5 минут. ModelSwitch полностью совместим с OpenAI SDK, поэтому изменить нужно всего две строки кода: base_url и api_key.
Почему стоит мигрировать с OpenAI на ModelSwitch
Прямое использование OpenAI API имеет ряд ограничений:
- Привязка к одному провайдеру — если OpenAI изменит цены или условия, перестроить инфраструктуру будет дорого
- Нет failover — при сбое OpenAI ваш сервис тоже падает
- Один провайдер — вы не сможете использовать Claude или Gemini без переписывания кода
- Проблемы с оплатой — международная карта, валютные операции, отсутствие закрывающих документов
ModelSwitch решает все эти проблемы, сохраняя полную совместимость с вашим существующим кодом.
До и после: что меняется в коде
Python: до и после
До (прямой OpenAI):
from openai import OpenAI
client = OpenAI(
api_key="sk-ваш-ключ-openai"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Привет!"}]
)
После (ModelSwitch):
from openai import OpenAI
client = OpenAI(
base_url="https://api.modelswitch.ru/v1", # Изменение 1
api_key="msk_ваш_ключ" # Изменение 2
)
response = client.chat.completions.create(
model="gpt-4o", # Тот же model — или любой из 300+
messages=[{"role": "user", "content": "Привет!"}]
)
TypeScript: до и после
До:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-ваш-ключ-openai",
});
const response = await client.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: "Привет!" }],
});
После:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.modelswitch.ru/v1", // Изменение 1
apiKey: "msk_ваш_ключ", // Изменение 2
});
const response = await client.chat.completions.create({
model: "gpt-4o", // Или "claude-3.5-sonnet", "gemini-2.0-pro"...
messages: [{ role: "user", content: "Привет!" }],
});
cURL: до и после
До:
curl https://api.openai.com/v1/chat/completions \
-H "Authorization: Bearer sk-ваш-ключ-openai" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Привет!"}]}'
После:
curl https://api.modelswitch.ru/v1/chat/completions \
-H "Authorization: Bearer msk_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Привет!"}]}'
Использование переменных окружения
Рекомендуемый подход — хранить настройки в переменных окружения:
# .env
OPENAI_BASE_URL=https://api.modelswitch.ru/v1
OPENAI_API_KEY=msk_ваш_ключ
OpenAI SDK автоматически подхватит эти переменные, так что код менять вообще не придётся:
from openai import OpenAI
# SDK автоматически читает OPENAI_BASE_URL и OPENAI_API_KEY
client = OpenAI()
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Привет!"}]
)
Полная совместимость с OpenAI API
ModelSwitch поддерживает все эндпоинты OpenAI API:
/v1/chat/completions— генерация текста (включая streaming)/v1/embeddings— создание эмбеддингов/v1/images/generations— генерация изображений (DALL-E)/v1/audio/transcriptions— распознавание речи (Whisper)/v1/audio/speech— синтез речи (TTS)/v1/models— список доступных моделей
Что вы получаете после миграции
- 300+ моделей — GPT-4o, Claude, Gemini, Llama, Mistral, DeepSeek и другие
- Единый API-ключ — не нужно управлять аккаунтами у каждого провайдера
- Оплата в рублях — безналичный расчёт, счета, акты, УПД
- Аналитика — дашборд с расходами по моделям, проектам и ключам
- Failover — автоматическое переключение на альтернативную модель при сбоях
Часто задаваемые вопросы
В: Нужно ли переписывать весь код?
О: Нет, достаточно изменить base_url и api_key. Весь остальной код работает без изменений.
В: Поддерживается ли streaming?
О: Да, потоковая генерация поддерживается полностью, включая server-sent events.
В: Что будет с моими промптами?
О: Промпты передаются в оригинальном виде. ModelSwitch не модифицирует содержимое запросов.
В: Есть ли разница в скорости?
О: Задержка составляет менее 50 мс к time-to-first-token. На практике это незаметно.
Заключение
Миграция с OpenAI на ModelSwitch — это два изменения в коде и пять минут работы. Взамен вы получаете доступ к 300+ AI моделям, оплату в рублях и защиту от vendor lock-in. Начните миграцию прямо сейчас.