API VEGA

Индекс документации

Получите полный индекс документации по адресу: https://api.vega.chat/docs/llms.txt Используйте этот файл, чтобы узнать о всех доступных страницах перед дальнейшим изучением.

Журнал изменений API

MD версия

Изменения в API VEGA, генерируемые из спецификации OpenAPI при каждом выпуске.

Записи на этой странице генерируются автоматически из спецификации OpenAPI diff‑ов при выпуске. Серьёзные изменения проверяются человеком перед публикацией. См. Версионирование API для определения, что считается серьёзным изменением и как объявляются устаревания. Пути эндпоинтов указаны относительно базового URL API (https://api.vega.chat/api/v1).

<Update label="August 19, 2026" tags={["BYOK"]} rss="Новое: управление ограничениями учетных данных BYOK (allowed_models, allowed_user_ids, allowed_api_key_hashes) через создание/обновление.">

Новые возможности

  • BYOK API: управление ограничениями учетных данных (allowed_models, allowed_user_ids, allowed_api_key_hashes) через создание/обновление. См. руководство BYOK для примеров и правил валидации. </Update>

<Update label="August 19, 2026" tags={["Errors","Schemas"]} rss="Действительные ошибки доступности моделей: новый объект error.availability с 11 машиночитаемыми кодами.">

Действительные ошибки доступности моделей

Ошибки недоступности модели (неизвестная модель, отсутствие эндпоинтов, устаревшая модель, исчерпана ёмкость провайдера, фильтрация по региону/приватности/ограничениям, завершённые :free‑промо) теперь содержат добавочный объект error.availability в оболочке ошибки, как в ответах без потоков, так и в потоковых чанках ошибок во всех трёх «кожах» API (Chat Completions, Responses, Anthropic Messages).

  • Новый объект error.availability с полями: code (один из 11 стабильных значений: model_not_found, wrong_endpoint, no_endpoints, model_deprecated, model_unavailable_upstream, capacity_exhausted, temporarily_unavailable, region_restricted, privacy_restricted, constraint_filtered, free_variant_ended), retryable, retry_after, requested_models, affected_providers, excluded_by, fallback_models, constraint и docs_url. См. Ошибки доступности моделей для полной таблицы кодов, описания полей и примеров полезных нагрузок.
  • Примечания к миграции: Изменение добавочное и обратно совместимое — error_type, http_status и message остаются без изменений, поэтому существующая обработка ошибок продолжит работать. Клиенты, которые сейчас парсят свободный текст message для различения условий доступности, должны переключиться на availability.code. Клиенты, ориентирующиеся только на HTTP‑статус, должны учитывать, что теперь неизвестные идентификаторы моделей в роутере чат‑завершений последовательно возвращают 400 (ранее могли появляться как 500). availability.retry_after отражает заголовок Retry-After в теле ответа и заполняется, когда любой попытанный эндпоинт предоставляет подсказку о повторе. error.metadata.previous_errors теперь имеет упрощённую стабильную форму ({provider, code, status}) и больше не содержит сырые тела ошибок upstream‑провайдеров — не парсите их. </Update>

<Update label="July 29, 2026" tags={["Benchmarks"]} rss="1 изменённый эндпоинт, 1 новая схема, 2 изменённые схемы.">

Изменённые эндпоинты

  • GET /benchmarks: обновлено описание; обновлён параметр source; обновлена схема ответа

Новые схемы

Изменённые схемы

  • UnifiedBenchmarksMeta: enum property_added
  • UnifiedBenchmarksResponse: пример изменён; добавлен новый вариант объединения

<Update label="July 28, 2026" tags={["Breaking","Files","Responses","Schemas"]} rss="2 серьёзных изменения, 5 изменённых эндпоинтов, 22 изменённых схемы.">

Серьёзные изменения

  • FusionCallAnalysisInProgressEvent: добавлено обязательное свойство analyst_model<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    • Никаких действий не требуется для существующих потребителей. analyst_model заменяет judge_model в этом потоковом событии; judge_model сохраняется как устаревший алиас, всегда содержащий то же значение.
    • Используется в POST /responses
  • $.tags: объект responses удалён<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    • Никаких действий не требуется. Тег OpenAPI responses переименован в Responses для согласованного Title Case во всей справке API. Это лишь изменение группировки документации: POST /api/v1/responses и его схемы не изменились, пространства имён SDK не изменились (client.responses.send() в TypeScript и Python, Sdk.Responses.Send() в Go), а URL‑ы документации эндпоинтов остались прежними.

Изменённые эндпоинты

Изменённые схемы

  • FusionAnalysisResult: обновлено описание

  • FusionCallAnalysisCompletedEvent: обновлено описание

  • FusionCallAnalysisInProgressEvent:

    • обновлено описание
    • пример изменён
    • новое свойство analyst_model
    • свойство judge_model устарело (алиас analyst_model, сохраняется для существующих потребителей)
    • Используется в POST /responses

  • FusionPlugin: обновлено описание

    <Expandable title="6 endpoints using this schema"> * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • FusionServerToolConfig: обновлено описание; обновлено свойство effort; обновлено свойство max_tokens

    <Expandable title="4 endpoints using this schema"> * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • FusionServerTool_OpenRouter: обновлено описание

    <Expandable title="4 endpoints using this schema"> * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • FusionSource: обновлено описание

  • OutputFusionServerToolItem: обновлено описание

  • ChatWebSearchShorthand: обновлено описание

  • WebSearchConfig: обновлено описание

    <Expandable title="4 endpoints using this schema"> * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) </Expandable>

  • WebSearchDomainFilter: пример изменён; новое свойство blocked_domains

  • WebSearchServerToolConfig: обновлено описание

  • AnthropicFileDocumentSource: пример изменён

  • FileDeleteResponse: пример изменён

  • FileListResponse: пример изменён

  • FileMetadata: пример изменён

  • GenerationResponse: обновлено свойство data_region

  • CreateGuardrailRequest: новое свойство enable_free_model_publication; новое свойство enable_free_model_training; новое свойство enable_paid_model_training

  • Guardrail:

    • пример изменён

    • новое свойство enable_free_model_publication

    • новое свойство enable_free_model_training

    • новое свойство enable_paid_model_training

      <Expandable title="4 endpoints using this schema"> - [`GET /guardrails`](/docs/api-reference/guardrails/list-guardrails) - [`GET /guardrails/{id}`](/docs/api-reference/guardrails/get-a-guardrail) - [`PATCH /guardrails/{id}`](/docs/api-reference/guardrails/update-a-guardrail) - [`POST /guardrails`](/docs/api-reference/guardrails/create-a-guardrail) </Expandable>

  • UpdateGuardrailRequest: новое свойство enable_free_model_publication; новое свойство enable_free_model_training; новое свойство enable_paid_model_training

  • AutoBetaRouterPlugin:

    • пример изменён

    • новое свойство cost_tier

    • устаревшее property_added

    • обновлено описание

      <Expandable title="6 endpoints using this schema"> - [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) - [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) - [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) - [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) - [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) - [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • AutoRouterPlugin:

    • пример изменён

    • новое свойство cost_tier

    • устаревшее property_added

    • обновлено описание

      <Expandable title="6 endpoints using this schema"> - [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) - [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) - [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) - [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) - [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) - [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>
</Update>

<Update label="July 27, 2026" tags={["Embeddings","Schemas"]} rss="1 изменённый эндпоинт, 2 изменённые схемы.">

Изменённые эндпоинты

Изменённые схемы

  • Quantization: enum property_added

    <Expandable title="10 endpoints using this schema"> * [`GET /endpoints/zdr`](/docs/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints) * [`GET /models/{author}/{slug}/endpoints`](/docs/api-reference/endpoints/list-all-endpoints-for-a-model) * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /embeddings`](/docs/api-reference/embeddings/submit-an-embedding-request) * [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /rerank`](/docs/api-reference/rerank/submit-a-rerank-request) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • ReasoningFormat: enum property_added

    <Expandable title="4 endpoints using this schema"> * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>
</Update>

<Update label="July 25, 2026" tags={["BYOK","Breaking","Responses","Schemas"]} rss="2 серьёзных изменения, 2 изменённых эндпоинта, 5 изменённых схем.">

Серьёзные изменения

  • POST /responses: удалено свойство beta.responses в тегах
    • Миграция: никаких действий для HTTP‑клиентов. API Responses теперь GA. beta.responses был лишь тегом группировки OpenAPI и пространством имён SDK, а не URL. POST /api/v1/responses и его схемы запросов/ответов не изменились, поэтому сырые HTTP‑вызыватели и совместимые с OpenAI клиенты (включая SDK OpenAI Agents) изменений не требуют. Эндпоинт теперь отображается под Responses, а не Beta responses в справке API.
    • Миграция для пользователей SDK: опционально до снятия. Каноническое пространство имён теперь responses с client.responses.send() (TypeScript, Python) и client.Responses.Send() (Go). Пространство имён beta.responses и отдельная функция TypeScript betaResponsesSend продолжают работать как устаревшие алиасы; их удаление будет анонсировано здесь с датой снятия перед выпуском.
  • $.tags: объект beta.responses удалён
    • То же изменение на уровне спецификации: определение тега beta.responses исчезло из $.tags.

Изменённые эндпоинты

Изменённые схемы

  • MessagesStartEvent: обновлено свойство provider

  • ProviderName: enum property_added

    <Expandable title="11 endpoints using this schema"> * [`GET /endpoints/zdr`](/docs/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints) * [`GET /models/{author}/{slug}/endpoints`](/docs/api-reference/endpoints/list-all-endpoints-for-a-model) * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /embeddings`](/docs/api-reference/embeddings/submit-an-embedding-request) * [`POST /images`](/docs/api-reference/images/generate-an-image) * [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /rerank`](/docs/api-reference/rerank/submit-a-rerank-request) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • ProviderOptions: новое свойство claude-on-aws

    <Expandable title="4 endpoints using this schema"> * [`POST /audio/speech`](/docs/api-reference/tts/create-speech) * [`POST /audio/transcriptions`](/docs/api-reference/stt/create-transcription) * [`POST /images`](/docs/api-reference/images/generate-an-image) * [`POST /videos`](/docs/api-reference/video-generation/submit-a-video-generation-request) </Expandable>

  • ProviderResponse: enum property_added

  • BYOKProviderSlug: enum property_added

    <Expandable title="4 endpoints using this schema"> * [`GET /byok`](/docs/api-reference/byok/list-byok-provider-credentials) * [`GET /byok/{id}`](/docs/api-reference/byok/get-a-byok-provider-credential) * [`PATCH /byok/{id}`](/docs/api-reference/byok/update-a-byok-provider-credential) * [`POST /byok`](/docs/api-reference/byok/create-a-byok-provider-credential) </Expandable>
</Update>

<Update label="July 24, 2026" tags={["Schemas"]} rss="8 изменённых схем.">

Изменённые схемы

  • MessagesStartEvent: обновлено свойство provider

  • ProviderName: enum property_added

    <Expandable title="11 endpoints using this schema"> * [`GET /endpoints/zdr`](/docs/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints) * [`GET /models/{author}/{slug}/endpoints`](/docs/api-reference/endpoints/list-all-endpoints-for-a-model) * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /embeddings`](/docs/api-reference/embeddings/submit-an-embedding-request) * [`POST /images`](/docs/api-reference/images/generate-an-image) * [`POST /messages`](/docs/api-reference/anthropic-messages/create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /rerank`](/docs/api-reference/rerank/submit-a-rerank-request) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • ProviderOptions: новое свойство voyageai

    <Expandable title="4 endpoints using this schema"> * [`POST /audio/speech`](/docs/api-reference/tts/create-speech) * [`POST /audio/transcriptions`](/docs/api-reference/stt/create-transcription) * [`POST /images`](/docs/api-reference/images/generate-an-image) * [`POST /videos`](/docs/api-reference/video-generation/submit-a-video-generation-request) </Expandable>

  • ProviderResponse: enum property_added

  • AnthropicCompactionBlock: новое свойство encrypted_content

  • MessagesToolAdditionBlock: новое свойство cache_control; добавлен новый вариант объединения; свойство type удалено

    • tool расширен от единственного объекта tool_reference до объединения tool_reference, mcp_tool_reference (name + server_name) и mcp_toolset_reference (server_name). Вариант tool_reference остался без изменений, поэтому существующие полезные нагрузки вида { "type": "tool_reference", "name": "…" } остаются валидными. Свойства name и type перемещены в этот вариант, а не удалены.
    • Используется в POST /messages, POST /presets/{slug}/messages

  • MessagesToolRemovalBlock: новое свойство cache_control; добавлен новый вариант объединения; свойство type удалено

    • tool расширен аналогично MessagesToolAdditionBlock; существующие payloads tool_reference остаются валидными.
    • Используется в POST /messages, POST /presets/{slug}/messages

  • ORAnthropicStopReason: enum property_added

<Update label="July 8, 2026" tags={["Schemas"]} rss="1 новая схема, 1 изменённая схема.">

Новые схемы

  • ImageGenTextChunkEvent

Изменённые схемы

  • ImageStreamingResponse: добавлен новый вариант объединения

<Update label="July 7, 2026" tags={["Datasets","Images","Models","STT"]} rss="3 изменённых эндпоинта, 1 новый код ответа, 3 новые схемы, 6 изменённых схем.">

Изменённые эндпоинты

  • POST /audio/transcriptions: обновлено описание; тело запроса теперь принимает multipart/form-data
  • GET /datasets/rankings-daily:
    • обновлено описание
    • новый параметр category
    • новый параметр context_bucket
    • новый параметр language_type
    • новый параметр modality
    • новый параметр period
  • GET /models:
    • новый параметр max_age_days
    • новый параметр max_agentic_index
    • новый параметр max_coding_index
    • новый параметр max_intelligence_index
    • новый параметр max_output_price
    • новый параметр max_tool_success_rate
    • новый параметр min_age_days
    • новый параметр min_agentic_index
    • новый параметр min_coding_index
    • новый параметр min_intelligence_index
    • новый параметр min_output_price
    • новый параметр min_tool_success_rate
    • обновлено описание
    • обновлён параметр sort

Новые коды ответа

Новые схемы

Изменённые схемы

  • ChatFunctionTool: добавлен новый вариант объединения

  • FusionServerToolConfig: обновлено описание

    <Expandable title="4 endpoints using this schema"> * [`POST /chat/completions`](/docs/api-reference/chat/create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/create-a-response) </Expandable>

  • ImageGenCompletedEvent: обновлено описание; пример изменён

  • ImageGenerationResponse: обновлено свойство media_type

  • STTRequest: новое свойство response_format; новое свойство timestamp_granularities

  • STTResponse:

    • новое свойство duration
    • новое свойство language
    • новое свойство segments
    • новое свойство task
    • новое свойство words
    • Используется в POST /audio/transcriptions </Update>

<Update label="July 3, 2026" tags={["Workspaces"]} rss="1 новый эндпоинт, 1 новая схема.">

Новые эндпоинты

Новые схемы

</Update>