идентификаторы моделей

модель выбирается в самом запросе — в поле model. никакой предварительной настройки не требуется: чтобы сменить модель, достаточно поставить другое значение.

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

идентификатор модели

идентификатор состоит из двух частей, разделённых слэшем: вендор — тот, кто создал модель, — и название модели.

openai/gpt-5-mini
anthropic/claude-sonnet-4.5
google/gemini-3.5-flash
x-ai/grok-4.20

регистр не важен. в коде надёжнее всегда писать идентификатор целиком.

короткое имя

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

подстановка не угадывает вендора по названию модели: claude-sonnet-4.5 на /v1/chat/completions превратится в несуществующую openai/claude-sonnet-4.5 и вернёт ошибку Model not supported.

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

на пути google модель указывается без вендора: gemini-3.5-flash, не google/gemini-3.5-flash.

какие модели доступны

в первой версии api — текстовые модели openai, anthropic, google и xai. каталог будет шире, чем у типичного прокси: список пополняется без смены адреса и ключа.

программно список отдаёт эндпоинт /v1/models:

curl "https://api.airakurs.ru/v1/models" \
    -H "Authorization: Bearer <КЛЮЧ>"

в ответе — идентификаторы всех моделей, доступных для запросов:

{
    "object": "list",
    "data": [
        {
            "id": "openai/gpt-5-mini",
            "object": "model",
            "created": 1745884800,
            "owned_by": "openai"
        }
    ]
}

данные об одной модели можно запросить по её идентификатору — GET /v1/models/openai/gpt-5-mini.

что дальше

• быстрый старт — первый запрос с готовыми примерами.
• api-ключи — как ограничить ключ списком разрешённых моделей.

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