Глоссарий

Глоссарий

Краткий справочник терминов, используемых в документации Arka AI и при работе с платформой. Определения даны в контексте AI-моделей и API.

Термины

LLM (Большая языковая модель) : Нейросетевая модель, обученная на больших объёмах текста для генерации и понимания языка. Примеры: DeepSeek-R1, Qwen3.5, GLM-5.2. Способна отвечать на вопросы, писать код, переводить и анализировать текст.

Токен : Единица текста (слово, часть слова или символ), в которых модель обрабатывает входные и выходные данные. Цены на Arka AI указываются за 1 миллион токенов. В среднем 1 токен ≈ 0.75 слова для русского языка и ≈ 0.75 слова для английского.

Контекстное окно : Максимальное количество токенов, которые модель может принять на вход (включает системный промпт, запрос пользователя_ID историю диалога и все предыдущие ответы). Например, DeepSeek-R1 имеет контекстное окно в 32 768 токенов, а GLM-5.2 — 128 000 токенов.

Инференс : Процесс вывода модели — получение ответа на основе входного запроса. Когда вы отправляете запрос к API, модель выполняет инференс: пропускает промпт через свои слои и генерирует ответ токен за токеном. Время инференса зависит от размера модели и длины ответа.

Fine-tuning (Тонкая настройка) : Дообучение предварительно обученной модели на специфическом наборе данных для улучшения результатов в конкретной области. Например, общую языковую модель можно дообучить на медицинских текстах, чтобы она точнее отвечала на вопросы врачей. На Arka AI интерфейс для запуска fine-tuning доступен в разделе «Обучение» (Training). Важно: в текущей версии платформы запуск обучения ограничен доступностью inference-бэкенда.

Embeddings (Эмбеддинги) : Векторные представления текста — числовые векторы фиксированной длины, которые кодируют семантическое значение текста. Используются для семантического поиска (найти «похожий по смыслу», а не по ключевым словам), кластеризации документов и построения RAG-систем.

RAG (Retrieval-Augmented Generation) : Техника, комбинирующая поиск по внешней базе знаний с генерацией ответа моделью. Вместо того чтобы «вписывать» все знания в промпт (что ограничено контекстным окном), RAG ищет релевантные документы в базе и подаёт их модели вместе с запросом. Обеспечивает более точные и актуальные ответы на вопросы по специфическим документам.

GPU (Графический процессор) : Специализированное аппаратное обеспечение, изначально созданное для компьютерной графики, но ставшее стандартом для вычислений нейросетей. GPU выполняет тысячи параллельных операций, что делает его идеальным для инференса и обучения LLM. На Arka AI GPU-инстансы можно арендовать через раздел Compute.

API-ключ : Уникальный идентификатор, используемый для аутентификации запросов к API Arka AI. Ключ создаётся в разделе «Настройки → API-ключи», показывается однократно при создании и передаётся в заголовке Authorization: Bearer <ключ>. Ключ можно ограничить по ресурсам (моделям или конечным точкам), к которым он предоставляет доступ.

OAuth2 : Протокол авторизации, позволяющий сторонним приложениям получать доступ к API от имени пользователя без передачи пароля или API-ключа. Приложение перенаправляет пользователя на страницу авторизации Arka AI, пользователь подтверждает разрешения, и приложение получает токен доступа.

MCP (Model Context Protocol) : Протокол для подключения AI-клиентов (IDE, чат-приложений, инструментов командной строки) к моделям через стандартизированный интерфейс. Вместо того чтобы каждое приложение реализовывало свою интеграцию с API Arka AI, MCP предоставляет единый способ подключения. Поддерживается в Cursor, Claude Code, Cline, Continue и других инструментах.

Serverless API : Модель доступа к API, при которой инфраструктура автоматически масштабируется под нагрузку, а пользователь платит только за использованные токены. Не нужно арендовать выделенный GPU-инстанс или настраивать сервер — достаточно отправить запрос к API, и платформа сама направит его на доступный GPU. Все модели в каталоге Arka AI доступны через serverless API.

Купон : Таргетированный кредит, который можно применить к определённым вендорам, регионам или типам инстансов. Купоны позволяют организациям распределять бюджет между командами: например, выдать купон на использование только текстовых моделей определённого поставщика с заданным лимитом.

Namespace : Пространство имён — пользователь или организация, в рамках которого учитываются ресурсы и баланс. Ваш namespace определяет, где создаются модели, датасеты и API-ключи, и откуда списываются средства при использовании API. Организации создают общий namespace для всех участников.

OpenAI-совместимое API : API, следующее формату запросов и ответов OpenAI, что позволяет использовать стандартные клиентские библиотеки без модификации. Arka AI предоставляет конечную точку /api/v1/chat/completions, полностью совместимую с форматом OpenAI Chat Completions.

Чат-комплишен (Chat Completion) : Тип запроса к модели, при котором вы отправляете список сообщений (роль + текст), а модель генерирует следующее сообщение. В отличие от простого текстового комплишена, чат-комплишен поддерживает диалоговую структуру с ролями: system (инструкции модели), user (сообщения пользователя) и assistant (предыдущие ответы модели).

Температура (Temperature) : Параметр генерации модели, управляющий степенью случайности ответов. Низкая температура (~0.1) даёт более детерминированные и предсказуемые ответы (полезно для кода или фактов). Высокая температура (~0.8–1.0) даёт более творческие и разнообразные ответы (полезно для генерации идей). Диапазон: от 0 до 2.

Rate Limit (Ограничение частоты) : Максимальное количество запросов, которое вы можете отправлять к API за единицу времени. Ограничения варьируются в зависимости от вашего тарифа и модели. При превышении лимита API возвращает ошибку 429 (Too Many Requests). Лимиты публикуются в карточке каждой модели.

Webhook : Механизм обратного вызова: Arka AI отправляет HTTP-запрос на ваш URL при наступлении определённого события (например, завершение обучения модели или изменение статуса заказа). Используйте вебхуки для построения асинхронных интеграций без постоянного опроса статуса API.