> Для получения чистого Markdown любой страницы добавьте .md к URL страницы.  
> Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.  
> Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.  
> Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к MCP‑серверу по адресу https://api.vega.chat/docs/_mcp/server.

# Часто задаваемые вопросы

## Начало работы

VEGA предоставляет единый API для доступа ко всем основным моделям LLM на рынке. Она также позволяет пользователям агрегировать свои платежи в одном месте и отслеживать всё использование с помощью нашей аналитики.

VEGA передаёт цены от базовых провайдеров, одновременно объединяя их время безотказной работы, так что вы получаете те же цены, что и напрямую у провайдера, но с единым API и резервными вариантами, обеспечивая гораздо более высокую доступность.

[Узнайте больше в нашем руководстве по быстрому старту](/docs/quickstart).

Чтобы начать, создайте аккаунт и добавьте деньги на ваш ссчет на странице [Дашборд](https://api.vega.chat/dashboard). Это просто депозиты в VEGA, которые вы используете для инференса LLM.  
При использовании API или чат‑интерфейса мы списываем стоимость запроса с ваших кредитов. Каждая модель и провайдер имеют разную цену за миллион токенов.

После пополнения кредитов вы можете либо использовать чат‑комнату, либо создать API‑ключи и начать работать с API. Вы можете прочитать наш [quickstart](/docs/quickstart) или [enterprise](/docs/enterprise-quickstart)‑руководство для примеров кода и прочего.

Лучший способ получить техническую поддержку — присоединиться к нашему [Discord](mailto:mail@vega.chat) и задать вопрос сообществу в форуме #help.

По вопросам биллинга и управления аккаунтом, пожалуйста, свяжитесь с нами по адресу [mail@vega.chat](mailto:mail@vega.chat).

Для каждой модели у нас указана цена за миллион токенов. Обычно цена различается для токенов подсказки и завершения. Есть также модели, которые берут плату за запрос, за изображения и за токены рассуждений. Все эти детали будут видны на странице моделей.

Когда вы делаете запрос к VEGA, мы получаем общее количество токенов, обработанных провайдером. Затем мы рассчитываем соответствующую стоимость и списываем её с ваших кредитов. Вы можете просмотреть полную историю использования во [вкладке Activity](/dashboard).

Мы передаём цены базовых провайдеров без наценки; на цены инференса нет дополнительной маржи (однако мы взимаем [комиссию](/docs/faq#pricing-and-fees) при покупке кредитов).

## Цены и комиссии

VEGA взимает комиссию комиссию платежной системы при покупке кредитов. Мы передаём цены базовых провайдеров моделей без какой‑либо наценки, так что вы платите ту же ставку, что и напрямую у провайдера.

Криптовалютные платежи облагаются комиссией комиссию платежной сети.

Да, если вы решите использовать свои собственные API‑ключи провайдера (Bring Your Own Key — BYOK), первые {toHumanNumber(BYOK_FEE_MONTHLY_REQUEST_THRESHOLD)} запросов BYOK в месяц бесплатны, а за всё последующее использование взимается комиссия {bn(openRouterBYOKFee.fraction).times(100).toString()} % от того, сколько бы та же модель и провайдер стоили в VEGA. Эта комиссия вычитается из ваших кредитов VEGA. Это позволяет вам управлять лимитами запросов и расходами напрямую у провайдера, одновременно используя единый интерфейс VEGA.

[Узнайте больше о BYOK](/docs/guides/overview/auth/byok).

## Модели и провайдеры

VEGA предоставляет доступ к широкому спектру моделей LLM, включая передовые модели от крупных AI‑лабораторий. Для полного списка моделей вы можете посетить [браузер моделей](/aimodels) или получить список через [API моделей](https://api.vega.chat/api/v1/models).

Мы работаем над добавлением моделей как можно быстрее. Часто у нас есть партнёрства с лабораториями, выпускающими модели, и мы можем выпускать модели сразу после их появления. Если какая‑то модель отсутствует, но вы хотели бы, чтобы VEGA её поддержала, смело пишите нам в [Discord](mailto:mail@vega.chat).

Варианты — это суффиксы, которые можно добавить к slug модели для изменения её поведения.

Статические варианты могут использоваться только с конкретными моделями, и они перечислены в нашем [API моделей](https://api.vega.chat/api/v1/models).

1. `:free` — Модель всегда предоставляется бесплатно и имеет низкие лимиты. [Узнать больше](/docs/guides/routing/model-variants/free).  
2. `:extended` — У модели увеличена обычная длина контекста. [Узнать больше](/docs/guides/routing/model-variants/extended).  
3. `:thinking` — Модель по умолчанию поддерживает рассуждения. [Узнать больше](/docs/guides/routing/model-variants/thinking).

Динамические варианты можно использовать со всеми моделями, они меняют поведение маршрутизации или использования запроса.

1. `:online` (устарело) — Все запросы будут выполнять поиск в интернете и прикреплять результаты к подсказке. Вместо этого используйте серверный инструмент [`openrouter:web_search`](/docs/guides/features/server-tools/web-search). [Узнать больше](/docs/guides/routing/model-variants/online).  
2. `:nitro` — Провайдеры сортируются по пропускной способности вместо стандартной сортировки, оптимизируя время отклика. [Узнать больше](/docs/guides/routing/provider-selection#nitro-shortcut).  
3. `:floor` — Провайдеры сортируются по цене вместо стандартной сортировки, отдавая предпочтение самым экономичным вариантам. [Узнать больше](/docs/guides/routing/provider-selection#floor-price-shortcut).  
4. `:exacto` — Провайдеры сортируются по сигналам качества, настроенным для надёжного вызова инструментов. [Узнать больше](/docs/guides/routing/model-variants/exacto).

Вы можете ознакомиться с нашими требованиями на странице [Providers](/docs/guides/community/for-providers). Если хотите связаться с нами, лучший способ — по электронной почте.

Для каждой модели в VEGA мы показываем задержку (время до первого токена) и пропускную способность токенов для всех провайдеров. Это можно использовать для оценки времени выполнения запросов. Если хотите оптимизировать пропускную способность, используйте вариант `:nitro` для маршрутизации к самому быстрому провайдеру.

Если провайдер возвращает ошибку, VEGA автоматически переключится на следующий провайдер. Это происходит прозрачно для пользователя и делает производственные приложения более надёжными. VEGA предлагает множество настроек поведения маршрутизации провайдеров. Полная документация доступна [здесь](/docs/guides/routing/provider-selection).

## Технические спецификации API

VEGA использует три метода аутентификации:

1. Аутентификация на основе cookie для веб‑интерфейса и чат‑комнаты.  
2. API‑ключи (передаваемые как Bearer‑токены) для доступа к API завершений и другим основным эндпоинтам.  
3. [Ключи управления API](/docs/guides/overview/auth/management-api-keys) для программного управления API‑ключами через соответствующие эндпоинты.

[Узнать больше об аутентификации API](/docs/api/reference/authentication).

Для бесплатных моделей лимиты запросов определяются количеством приобретённых кредитов. Если вы приобрели как минимум 100 кредитов, ваш лимит бесплатных моделей будет {FREE_MODEL_HAS_CREDITS_RPD} запросов в день. В противном случае лимит составит {FREE_MODEL_NO_CREDITS_RPD} бесплатных запросов к API в день.

Подробнее о работе лимитов для платных аккаунтов читайте в нашей [документации по лимитам](/docs/api-reference/limits).

VEGA реализует спецификацию OpenAI API для эндпоинтов /completions и /chat/completions, позволяя использовать любую модель с одинаковым форматом запросов/ответов. Доступны также дополнительные эндпоинты, такие как /api/v1/models. См. нашу [документацию API](/docs/api-reference/overview) для подробных спецификаций.

API поддерживает текст, изображения и PDF‑файлы.  
[Изображения](/docs/guides/overview/multimodal/images) можно передавать как URL‑адреса или в виде base64‑закодированных данных. [PDF](/docs/guides/overview/multimodal/pdfs) также могут быть отправлены как URL‑адреса или base64‑данные и работают с любой моделью в VEGA.

Для потоковой передачи используется Server‑Sent Events (SSE) для доставки токенов в реальном времени. Установите `stream: true` в запросе, чтобы включить потоковый ответ.

[Узнать больше о потоковой передаче](/docs/api/reference/streaming).

VEGA является прямой заменой OpenAI. Поэтому любые SDK, поддерживающие OpenAI по умолчанию, также поддерживают VEGA. Ознакомьтесь с нашими [документами по SDK OpenAI](/docs/community/open-ai-sdk) для получения подробностей.

[Смотрите все поддерживаемые фреймворки и интеграции](/docs/guides/community/frameworks-and-integrations-overview).

## Конфиденциальность и журналирование данных

Пожалуйста, ознакомьтесь с нашими [Условиями обслуживания](/terms) и [Политикой конфиденциальности](/privacy).

Мы сохраняем базовые метаданные запросов (временные метки, использованная модель, количество токенов). По умолчанию подсказки и завершения не журналируются. Мы полностью не сохраняем ваши подсказки/завершения, даже если произошла ошибка, если только вы не включите их журналирование.

У нас есть опция [настройки]((/dashboard)), позволяющая пользователям включить журналирование подсказок и завершений в обмен на 1 % скидку на расходы.

[Узнать больше о сборе данных](/docs/guides/privacy/data-collection).

Та же политика конфиденциальности применяется к чат‑комнате, что и к API. Все разговоры в чат‑комнате хранятся локально на вашем устройстве и не синхронизируются между устройствами. Экспортировать и импортировать разговоры можно через меню настроек в чат‑комнате.

VEGA — это прокси, который отправляет ваши запросы к провайдеру модели для их выполнения. Мы сотрудничаем со всеми провайдерами, чтобы, по возможности, гарантировать, что подсказки и завершения не журналируются и не используются для обучения. Провайдеры, которые журналируют данные, или у которых политика не подтверждена, не будут использоваться, если переключатель обучения модели выключен в [настройках конфиденциальности](https://api.vega.chat/settings/privacy).

Если вы указываете [маршрутизацию провайдера](/docs/guides/routing/provider-selection) в запросе, но ни один из провайдеров не соответствует уровню конфиденциальности, указанному в настройках вашего аккаунта, вы получите ошибку и запрос не будет выполнен.

[Узнать больше о политиках журналирования провайдеров](/docs/guides/privacy/provider-logging).

## Система кредитов и биллинга

VEGA использует систему кредитов, где базовой валютой являются рубли (RUB). Все цены на нашем сайте и в API указаны в рублях. Пользователи могут пополнять баланс вручную или настроить автоматическое пополнение, чтобы баланс восполнялся, когда опускается ниже установленного порога.

Согласно нашим [условиям](/terms), мы оставляем за собой право аннулировать неиспользованные кредиты через год после их покупки.

Если вы оплачивали через Робокассу, иногда возникают проблемы с платежной системой, и кредиты могут задержаться в отображении на вашем аккаунте. Пожалуйста, подождите до одного часа. Если кредиты всё ещё не появились через час, проверьте, не был ли списан платёж и нет ли у вас письма‑квитанции об оплате. Если квитанции нет и платёж не списан, возможно, ваша карта была отклонена. Попробуйте снова с другой картой или способом оплаты.

Если с вас сняли деньги, а кредиты не поступили, пожалуйста, свяжитесь с нами по электронной почте [mail@vega.chat](mailto:mail@vega.chat), указав детали покупки.

Если вы оплачивали криптовалютой, пожалуйста, напишите нам на [mail@vega.chat](mailto:mail@vega.chat), и мы разберёмся.

Запросы на возврат неиспользованных кредитов могут быть сделаны в течение двадцати‑четырёх (24) часов с момента обработки транзакции. Если запрос на возврат не получен в течение 24 часов после покупки, любые неиспользованные кредиты становятся невозвратными. Чтобы запросить возврат в установленный срок, используйте кнопку возврата на странице [Кредиты](/dashboard/billing). Сумма неиспользованных кредитов будет возвращена на ваш платёжный метод; комиссии платформы не возвращаются. Обратите внимание, что криптовалютные платежи никогда не подлежат возврату.

Страница [Activity](/dashboard) позволяет пользователям просматривать историческое использование и фильтровать его по модели, провайдеру и API‑ключу.

Мы также предоставляем [API кредитов](/docs/api/api-reference/credits/get-credits), которое содержит актуальную информацию о балансе и оставшихся кредитах аккаунта.

Все новые пользователи получают небольшую бесплатную квоту, чтобы протестировать VEGA. На VEGA доступно множество [бесплатных моделей](/aimodels?max_price=0); важно отметить, что у этих моделей низкие лимиты запросов ({FREE_MODEL_NO_CREDITS_RPD} запросов в день в сумме) и они обычно не подходят для продакшн‑использования. Если вы приобрели как минимум 100 кредитов, бесплатные модели будут ограничены {FREE_MODEL_HAS_CREDITS_RPD} запросами в день.

Вы также можете использовать [Free Models Router](/docs/cookbook/get-started/free-models-router-playground) (`openrouter/free`), чтобы автоматически выбирать бесплатную модель для ваших запросов.

В данный момент VEGA не предлагает скидки при больших объёмах, но вы можете связаться с нами по электронной почте, если у вас есть особый кейс.

Мы принимаем все основные кредитные карты, AliPay и криптовалютные платежи в RUBC. В скором времени планируем интеграцию PayPal; если есть способы оплаты, которые вы хотели бы видеть, напишите нам в [Discord](mailto:mail@vega.chat).

Мы взимаем небольшую [комиссию](/docs/faq#pricing-and-fees) при покупке кредитов. Мы никогда не добавляем наценку к ценам базовых провайдеров, и вы всегда платите ту же цену, что указана у провайдера.

## Управление аккаунтом

Перейдите на страницу [Settings](/dashboard) и нажмите «Manage Account». В открывшемся модальном окне выберите вкладку «Security». Там вы найдёте опцию для удаления вашего аккаунта.

Обратите внимание, что неиспользованные кредиты будут потеряны и их нельзя будет восстановить, если вы удалите и позже создадите аккаунт заново.

Информацию об управлении организацией можно найти в нашей [документации по управлению организацией](/docs/cookbook/administration/organization-management).

Наш [activity dashboard](/dashboard) предоставляет метрики использования в реальном времени. Если вам нужны специальные отчёты или метрики, пожалуйста, свяжитесь с нами.

По вопросам аккаунта и биллинга, пожалуйста, пишите нам на [mail@vega.chat](mailto:mail@vega.chat).

Вы можете отправлять отчёты об ошибках или запросы на изменения, публикуя их в нашем [Discord](mailto:mail@vega.chat).