Глоссарий API

Короткие определения терминов, которые встречаются в документации и каталоге моделей. Если термин не раскрыт, начните с быстрого старта или форматов API.

Адрес и авторизация

Base URL — корневой адрес API. Для OpenAI-совместимых запросов NeuroAPI это https://neuroapi.host/v1; к нему добавляется путь эндпоинта, например /chat/completions.

API-ключ — секрет, которым приложение подтверждает право использовать баланс. Создаётся в разделе Токены, передаётся в заголовке Authorization: Bearer.

Эндпоинт — конкретный путь API, например POST /v1/images/generations или POST /v1/messages.

Модель (Model ID) — точное имя модели в запросе. Должно совпадать с именем в каталоге; одна и та же модель может быть доступна не во всех форматах API.

Токены и стоимость

Токен — единица текста, которой измеряется запрос и ответ. Точное разбиение зависит от модели; стоимость считается по токенам входа и выхода.

Контекстное окно — максимальный объём текста, который модель учитывает за один запрос, включая сообщения и ответ. У разных моделей окно отличается.

Входные и выходные токены — то, что отправлено модели, и то, что она вернула. Часто тарифицируются по разным ставкам.

Кэш-ставка — цена чтения входных токенов при подтверждённом попадании в кэш провайдера. Применяется только к кэшированной части входа.

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

Порог объёма (tier) — граница по числу входных токенов одного запроса, выше которой применяются другие коэффициенты.

Квота и баланс — внутренний учёт средств аккаунта. Баланс пополняется в рублях; списание идёт по фактическому использованию моделей. Бонусный баланс — отдельная часть, которая расходуется после основного.

Форматы и функции

OpenAI-совместимый API — формат запросов и ответов, совместимый с OpenAI SDK: /v1/chat/completions, /v1/responses, /v1/images/generations.

Нативный формат — протокол конкретного поставщика: Anthropic Messages (/v1/messages) или Gemini (/v1beta/models/{model}:generateContent).

Стриминг (SSE) — потоковая отдача ответа по частям через Server-Sent Events. Позволяет показывать текст по мере генерации.

Function calling / tools — механизм, при котором модель возвращает структурированный вызов инструмента, а приложение выполняет его и передаёт результат. Поддержка зависит от модели.

Структурированный вывод — ответ в заданной схеме (например, JSON). Не все модели и форматы поддерживают его одинаково.

Мультимодальность — способность модели принимать не только текст, но и изображения, аудио, видео или файлы. Указывается в карточке модели.

Эмбеддинг — числовой вектор, представляющий смысл текста. Используется для поиска, кластеризации и RAG.

Задачи и надёжность

Асинхронная задача (async) — операция, которая выполняется на сервере, а клиент получает статус и результат опросом. Например, durable-генерация изображений.

Идемпотентность — свойство повторного запроса не создавать дубль операции. Для оплат и фоновых задач это критично.

Retryable-ошибка — временная ошибка, после которой безопасно повторить запрос или перейти на резервный канал. Решение принимает сервис, а не клиент.

Код 401 / 404 / 429 — ошибки авторизации, отсутствующего ресурса и превышения лимитов. Разбор — в документации по ошибкам.

RPM / TPM — ограничения на число запросов и токенов в минуту для ключа, тарифа или модели. Проверяются в лимитах.

Тарифы

Пилот — экономичный режим через неофициальные каналы. Возможны перебои и задержки.

Смарт — ровно одна физическая попытка Пилота, при безопасной для повтора ошибке — полная цепочка Оптимального.

Оптимальный — официальные каналы для продакшена и предсказуемой работы.

Подробнее — на странице тарифов и в документации по ценам.