OpenAI-compatible API: что это и как подключить

Определение

OpenAI-compatible API — это сервис, который принимает запросы в том же виде, в каком их принимает OpenAI, и отвечает в том же формате. Совместимость означает конкретные вещи: путь /v1/chat/completions, авторизация через Authorization: Bearer, тело с полями model и messages, ответ с массивом choices и объектом usage, потоковый режим через server-sent events.

Практический смысл: любая библиотека, написанная под OpenAI, работает с таким сервисом без изменений в логике. Меняются два значения — адрес и ключ.

Зачем это нужно

• Один интерфейс к моделям разных разработчиков — не нужно писать по клиенту на каждого.
• Инструменты, у которых есть поле «base URL», подключаются без правки кода.
• Смена модели — это смена строки в запросе, а не переписывание интеграции.
• Существующие SDK, обёртки и фреймворки продолжают работать.

Примеры кода

from openai import OpenAI

client = OpenAI(
    base_url="https://api.tokenator.top/v1",
    api_key="sk-your-tokenator-key",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

Обратите внимание: в base_url входит суффикс /v1, а метод SDK добавляет к нему /chat/completions сам.

Что поддерживает Tokenator

Помимо OpenAI-формата доступен Anthropic-совместимый вход. Это удобно для инструментов, изначально написанных под Claude: им не нужен слой совместимости, а модель при этом можно выбрать любую из каталога.

Границы совместимости

Совместимость формата не означает, что все модели умеют одно и то же. Изображения на входе, инструменты и reasoning зависят от конкретной модели и апстрима, а не от формата запроса. Что поддерживает конкретная модель — смотрите на её странице в каталоге.

Ещё одно отличие от прямого доступа к OpenAI: клиентские серверные инструменты веб-поиска и веб-фетча из запроса удаляются, а тексты ошибок апстрима заменяются общим сообщением.

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

Читайте дальше