openai-совместимый api

openai-совместимый api — шлюз, который принимает запросы в формате openai и направляет их к разным поставщикам текстовых моделей. на входе и выходе вы всегда работаете с протоколом openai, а конвертация форматов и маршрутизация выполняются на нашей стороне.

все маршруты совместимы с официальной спецификацией openai, включая форматы запросов, ответов и ошибок. поэтому официальный sdk работает без изменений — меняются только адрес и ключ.

базовый адрес

https://api.airakurs.ru/v1

клиент openai сам добавляет /v1 к базовому адресу. в sdk указывайте https://api.airakurs.ru/v1 целиком либо https://api.airakurs.ru — зависит от того, дописывает ли выбранная библиотека версию. у официального пакета openai в поле base_url ставят адрес с /v1.

доступные эндпоинты

эмбеддинги, изображения, аудио и видео в первой версии не принимаются.

адресация моделей

имя модели имеет вид вендор/название.

короткое имя без вендора на /v1/chat/completions считается моделью openai. для остальных вендоров указывайте идентификатор целиком. подробности — в статье модели.

пример

curl "https://api.airakurs.ru/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "google/gemini-3.5-flash",
        "messages": [
            {"role": "user", "content": "Привет!"}
        ]
    }'

from openai import OpenAI

client = OpenAI(api_key="<КЛЮЧ>", base_url="https://api.airakurs.ru/v1")
print(
    client.chat.completions.create(
        model="google/gemini-3.5-flash",
        messages=[{"role": "user", "content": "Привет!"}],
    )
    .choices[0]
    .message.content
)

что дальше

• генерация текста — роли, параметры, ответ.
• родной формат — когда запрос уходит без перевода.

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