Термины API
Поля, форматы и основные понятия
| Термин | Значение |
|---|---|
| API-ключ | Секрет для авторизации запросов |
| Базовый URL | Адрес сервиса до пути метода |
| Метод API | Сочетание HTTP-метода и пути |
| model | Идентификатор выбранной модели |
| Токен | Единица обработки текста или других данных моделью |
| Контекст | Входная история, инструкции и другие данные запроса |
| usage | Счётчики использования |
| Поток SSE | Последовательность событий ответа |
| Tool calling | Запрос модели на выполнение функции приложением |
| JSON Schema | Описание структуры и типов JSON |
| Reasoning | Дополнительное вычисление модели перед ответом |
| Алиас | Имя, которое может указывать на изменяемую версию модели |
Параметры и поддержка
Обязательный параметр нужен для корректного запроса Необязательный параметр можно не передавать, но его поддержка и значение по умолчанию зависят от модели
Неподдерживаемый параметр может вызвать ошибку или быть проигнорирован Успешный HTTP-статус не заменяет проверку структуры результата
Завершение
Причина завершения относится к генерации, а HTTP-статус к обработке запроса
Поэтому HTTP 200 и finish_reason: "length" означают успешное обращение с ограниченным результатом