Модели

Список моделей#

Актуальный каталог отдаёт GET /v1/models. Ключ необязателен, но с ключом в заголовке Authorization список включает и модели, открытые вашему аккаунту персонально.

curl https://ai-seller.vibe-codes.ru/v1/models \
  -H "Authorization: Bearer $AISELLER_API_KEY"

from openai import OpenAI

client = OpenAI(base_url="https://ai-seller.vibe-codes.ru/v1", api_key="$AISELLER_API_KEY")
for model in client.models.list():
    print(model.id)

Ответ — в формате OpenAI:

{
  "object": "list",
  "data": [
    {"id": "gpt-5.6-sol", "object": "model", "owned_by": "ai-seller"},
    {"id": "gpt-image-2.5", "object": "model", "owned_by": "ai-seller"}
  ]
}

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

ID модели#

ID — строка из каталога, например gpt-5.6-sol. Префикс вендора необязателен: встречаются и model, и vendor/model. Передавайте ID ровно в том виде, в каком его отдаёт GET /v1/models; в ответах шлюза поле model содержит тот же ID.

Тип модели и эндпоинт#

У каждой модели один тип — текст, изображения или видео, — и она работает только на эндпоинтах своего типа:

Модель на эндпоинте чужого типа отвечает 404 model_not_found, как несуществующая. Среди текстовых эндпоинтов модель работает на тех, чей формат поддерживает её провайдер: шлюз не переводит запросы из одного формата в другой (см. Обзор API).

Провайдеры и отказоустойчивость#

У модели может быть несколько провайдеров. Если провайдер не ответил или вернул сбой до начала ответа, шлюз повторяет запрос у следующего — для вас это один запрос с одним request_id. После того как ответ начал приходить, переключения уже нет: сбой посреди потока приходит событием ошибки (см. Стриминг).

Приватные модели и цены#

Часть моделей открывается аккаунту персонально: они видны в GET /v1/models только с вашим ключом, остальным отвечают 404 model_not_found. Для аккаунта могут действовать персональные цены. Как считается стоимость запроса — в разделе Баланс и стоимость; актуальные ставки по моделям можно уточнить на support@example.com.