Матрица параметров моделей¶
Матрица использует канонические имена. Адаптер протокола может использовать
нативное написание (max_output_tokens, stop_sequences,
generationConfig.topP и аналогичные), если live-каталог связывает его с тем
же параметром.
| Параметр | Назначение |
|---|---|
temperature |
температура sampling |
top_p |
nucleus sampling |
max_tokens |
лимит выходных токенов |
frequency_penalty |
штраф частоты |
presence_penalty |
штраф присутствия |
stop |
последовательности остановки |
seed |
подсказка для детерминированного sampling |
n |
число кандидатов |
stream |
потоковый ответ |
response_format |
формат структурированного вывода |
tools |
объявления tools/functions |
tool_choice |
политика выбора tool |
logprobs |
вероятности токенов |
top_logprobs |
верхние кандидаты log probability |
logit_bias |
карта смещений токенов |
user |
метка пользователя/вызывающей стороны |
model, messages, input, contents, prompt и обязательные аналоги
протокола — structural fields. Это не optional-capabilities, и отсутствие
записи capability не отклоняет их.
Как читать live-каталог¶
curl https://api.nexus-hub.ru/v1/catalog
Проверенная запись имеет вид:
{
"endpoint_family": "chat.completions",
"optional_parameters": ["temperature", "tools"],
"verified_at": "2026-08-15T00:00:00Z"
}
Пустой optional_parameters означает проверенное отсутствие всех перечисленных
optional-параметров для модели и endpoint. Отсутствующая запись означает, что
Nexus пока не знает ответ и сохраняет совместимый passthrough.
Безопасные примеры запросов¶
Примеры ниже допустимы только если live-каталог перечисляет capability для выбранной модели и endpoint.
Tools:
{"tools":[{"type":"function","function":{"name":"lookup","parameters":{"type":"object"}}}],"tool_choice":"auto"}
Структурированный вывод:
{"response_format":{"type":"json_object"}}
Penalties и streaming:
{"temperature":0.2,"top_p":0.9,"frequency_penalty":0.1,"presence_penalty":0,"stream":true}
Log probabilities:
{"logprobs":true,"top_logprobs":3}
Поддержка может различаться между OpenAI-compatible, Anthropic-compatible и
Gemini-compatible маршрутами и между моделями одного семейства. Доступный
набор моделей зависит от API-ключа: перед выбором запросите GET /v1/models.