Что такое OpenAI-совместимый API: почему иногда достаточно поменять base_url и api_key

Многие видят фразу "OpenAI-совместимый API" и думают, что речь обязательно про официальный API OpenAI.

Нет.

Точнее будет так: это API, который использует знакомый формат вызова в стиле OpenAI. Ваш код может продолжать работать через OpenAI SDK, но запрос уходит не обязательно в OpenAI, а на другую платформу с похожим интерфейсом.

Польза простая: если проект уже написан под OpenAI SDK, переход к моделям вроде Qwen или DeepSeek часто не требует переписывать все заново.

Это не официальный OpenAI API и не обещание GPT

Сначала важно убрать путаницу.

OpenAI-совместимый означает совместимый по формату интерфейса. Это не значит, что модель обязательно от OpenAI.

Платформа может принимать вызовы в стиле OpenAI SDK, но фактически отдавать DeepSeek, Qwen или другие модели.

OneKeyModel сейчас временно не поддерживает GPT, Claude и Gemini из-за политик и ограничений подключения. Практичный путь на текущем этапе — проверять доступные модели вроде Qwen и DeepSeek на реальных задачах.

Если вам нужен общий чек-лист перед подключением AI API в России, посмотрите материал про AI API в России. Здесь мы говорим именно о миграции и коде.

Два параметра, которые чаще всего меняют

Во многих сценариях миграции главное — поменять две вещи:

api_key="your-api-key"
base_url="https://api.onekeymodel.com/v1"

api_key показывает, кто вы. base_url определяет, куда отправляется запрос.

Модель выбирается параметром model:

model="deepseek-chat"

То есть идея такая: SDK остается привычным, адрес меняется, название модели меняется.

Пример на Python

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.onekeymodel.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "Перепиши этот текст как живое описание на русском"}
    ]
)

print(response.choices[0].message.content)

Главное здесь не в том, что код похож на OpenAI. Главное — низкая стоимость миграции. Не нужно сначала изучать полностью новый SDK, чтобы просто проверить модель.

Пример на JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "your-api-key",
  baseURL: "https://api.onekeymodel.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [
    { role: "user", content: "Generate 5 short product titles in Russian." },
  ],
});

console.log(response.choices[0].message.content);

Если вы уже делали админку, Telegram-бота или автоматический скрипт, такой стиль будет понятным.

Не нужно сразу писать большую обертку. Сначала добейтесь, чтобы самый короткий запрос прошел, а потом встраивайте его в проект.

Что менять при смене модели

Обычно смотрят на три поля:

base_url: адрес API;
api_key: ваш ключ;
model: имя модели.

Например, сегодня вы используете deepseek-chat. Когда появятся другие доступные модели, часто достаточно заменить значение model и прогнать тот же самый тест.

В этом и смысл OpenAI-совместимого API: бизнес-логика меняется меньше, а модели сравнивать проще.

Не меняйте все сразу. Оставьте один и тот же входной текст, поменяйте только модель и сравните качество, скорость и расход. Так понятнее, что изменилось именно из-за модели, а не из-за переписанного процесса.

Что такое messages

Новичков часто останавливает поле messages.

Проще всего думать о нем как об истории диалога, которую вы отправляете модели.

Самый простой вариант:

messages=[
    {"role": "user", "content": "Напиши описание продукта"}
]

Если модели нужен контекст, добавьте system:

messages=[
    {"role": "system", "content": "Ты редактор, который пишет живые русские тексты"},
    {"role": "user", "content": "Перепиши эту заметку как рекламное описание"}
]

Не усложняйте промпт в первый день. Сначала проверьте, справляется ли модель с основной задачей, а потом настраивайте тон, формат и ограничения.

Частые ошибки

Самые частые проблемы обычно очень простые:

в base_url забыли /v1 или написали его два раза;
в API-ключ попал лишний пробел;
имя модели написано неверно;
не хватает баланса;
запрос слишком длинный;
неправильный формат messages;
смешали streaming и обычный ответ;
перепутали тестовый и боевой ключ;
старые переменные окружения все еще указывают на другого провайдера.

Для первого подключения держите код коротким. Сначала один рабочий запрос, потом интеграция в большое приложение.

Если пришла ошибка, читайте не только последнюю строку. Часто там видно, что именно не так: авторизация, модель, баланс, формат запроса или лимит.

Где это полезно

OpenAI-совместимый API особенно удобен, если вы:

уже используете OpenAI SDK;
хотите подключить Telegram-бота;
хотите работать с LangChain, Dify, LlamaIndex или похожими инструментами;
добавляете AI во внутреннюю панель;
массово обрабатываете переводы, резюме или тексты;
сравниваете Qwen, DeepSeek и другие доступные модели.

Если ваша главная задача — найти аналог OpenRouter, почитайте материал про альтернативу OpenRouter. Если вы уже готовы подключать API, эта статья — техническая точка входа.

Итог

OpenAI-совместимый API — не магия. Он решает простую проблему миграции: не нужно переписывать SDK, инструменты и бизнес-логику только ради проверки другой модели.

Для разработчика это быстрее тестировать. Для команды это меньше поддержки. Для контента и операционных задач это проще встроить AI в реальные инструменты.

Начните с одного простого запроса, потом сравнивайте модели, контролируйте стоимость и постепенно переносите API в проект.