Миграция с OpenAI SDK на OfoxAI: Python, TypeScript и популярные фреймворки (2026)

Суть миграции

OfoxAI полностью совместим с OpenAI SDK. Для перехода с прямого подключения к OpenAI достаточно изменить два параметра: base_url и api_key. Весь остальной код остаётся без изменений.

В этом руководстве — миграция для Python и TypeScript, маппинг моделей, интеграция с популярными фреймворками (LangChain, LlamaIndex, Vercel AI SDK) и таблица совместимости API.

Миграция: Python

from openai import OpenAI

# Раньше: прямое подключение к OpenAI
# client = OpenAI(api_key="sk-openai-xxx")

# Теперь: через OfoxAI
client = OpenAI(
    base_url="https://api.ofox.ai/v1",    # добавить
    api_key="<Ваш OFOXAI_API_KEY>"       # заменить
)

# Остальной код не меняется!
response = client.chat.completions.create(
    model="openai/gpt-4o",  # добавить префикс провайдера
    messages=[{"role": "user", "content": "Hello!"}]
)

Две строки: base_url и api_key. Формат запросов, параметры, обработка ответов — всё идентично.

Миграция: TypeScript

import OpenAI from 'openai'

// Раньше: прямое подключение к OpenAI
// const client = new OpenAI({ apiKey: 'sk-openai-xxx' })

// Теперь: через OfoxAI
const client = new OpenAI({
  baseURL: 'https://api.ofox.ai/v1',      // добавить
  apiKey: '<Ваш OFOXAI_API_KEY>'         // заменить
})

// Остальной код не меняется!

Принцип тот же: baseURL и apiKey. Вся бизнес-логика сохраняется.

Именование моделей

OfoxAI использует формат provider/model-name для идентификации моделей:

Через OfoxAI также доступны модели других провайдеров:

Один SDK, один API Key — доступ ко всем моделям через единый интерфейс.

Совместимость API

OfoxAI поддерживает следующие функции OpenAI API:

Вся логика вашего приложения — от стриминга до Function Calling — работает без изменений.

Интеграция с фреймворками

LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.ofox.ai/v1",
    api_key="<Ваш OFOXAI_API_KEY>",
    model="openai/gpt-4o"
)

LlamaIndex

from llama_index.llms.openai import OpenAI

llm = OpenAI(
    api_base="https://api.ofox.ai/v1",
    api_key="<Ваш OFOXAI_API_KEY>",
    model="openai/gpt-4o"
)

Vercel AI SDK

import { createOpenAI } from '@ai-sdk/openai'

const ofoxai = createOpenAI({
  baseURL: 'https://api.ofox.ai/v1',
  apiKey: '<Ваш OFOXAI_API_KEY>'
})

const model = ofoxai('openai/gpt-4o')

Любой фреймворк или инструмент, поддерживающий OpenAI SDK, подключается к OfoxAI изменением base_url.

Практический пример: переход с прямого OpenAI

Допустим, у вас есть приложение на Python, использующее OpenAI напрямую:

# Текущая конфигурация
client = OpenAI(api_key="sk-openai-xxx")
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Привет"}]
)

Миграция:

1. Замените api_key на ключ OfoxAI
2. Добавьте base_url="https://api.ofox.ai/v1"
3. Добавьте префикс провайдера к модели: gpt-4o → openai/gpt-4o

# После миграции
client = OpenAI(
    base_url="https://api.ofox.ai/v1",
    api_key="<Ваш OFOXAI_API_KEY>"
)
response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Привет"}]
)

Готово. Три изменения, ноль простоя. Теперь через тот же SDK доступны модели Claude, Gemini, DeepSeek и других провайдеров.

Преимущества миграции

Зачем переходить на OfoxAI, если прямой OpenAI API работает?

• Доступ к 100+ моделям — один SDK, один ключ, все провайдеры
• Единый биллинг — не нужно управлять отдельными аккаунтами OpenAI, Anthropic, Google
• Аварийное переключение — при сбое одного провайдера запросы перенаправляются на другой
• Доступность — API-эндпоинт https://api.ofox.ai/v1 доступен из России без VPN

Решение типичных проблем

Ошибка “Invalid model”

Добавьте префикс провайдера к имени модели: openai/gpt-4o вместо gpt-4o.

Ошибка 401

API Key недействителен. Убедитесь, что используете ключ OfoxAI, а не OpenAI.

Функция не поддерживается

Убедитесь, что выбранная модель поддерживает нужную функцию. Например, не все модели поддерживают Vision или Function Calling.

Итог

Миграция с OpenAI SDK на OfoxAI — это изменение двух параметров: base_url на https://api.ofox.ai/v1 и api_key на ключ OfoxAI. Плюс добавление префикса provider/ к именам моделей. Совместимость полная: Chat Completions, Streaming, Function Calling, JSON Mode, Vision, Embeddings, Images Generation. Работает с Python, TypeScript, LangChain, LlamaIndex, Vercel AI SDK и любым другим фреймворком на базе OpenAI SDK.

Подробнее — в документации по совместимости с OpenAI SDK. API Key можно создать на ofox.ai.