API ВЕГА

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

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

versioning

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

MD версия

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

<Update label="August 19, 2026" tags={["BYOK"]} rss="New: manage BYOK credential restrictions (allowed_models, allowed_user_ids, allowed_api_key_hashes) via create/update.">

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

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

<Update label="July 29, 2026" tags={["Benchmarks"]} rss="1 modified endpoint, 1 new schema, 2 modified schemas.">

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

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

Новые схемы

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

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

<Update label="July 28, 2026" tags={["Breaking","Files","Responses","Schemas"]} rss="2 breaking changes, 5 modified endpoints, 22 modified schemas.">

Прерывающие изменения

  • FusionCallAnalysisInProgressEvent: добавлено обязательное свойство analyst_model<Badge stroke color="gray" className="changelog-status-badge">Действие не требуется</Badge>
    • Никаких действий не требуется для существующих потребителей. analyst_model заменяет judge_model в этом стриминговом событии; judge_model сохраняется как устаревший псевдоним, который всегда имеет то же значение.
    • Используется в POST /responses
  • $.tags: объект responses удалён<Badge stroke color="gray" className="changelog-status-badge">Действие не требуется</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 эндпоинтов используют эту схему"> * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

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

    <Expandable title="4 эндпоинта используют эту схему"> * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

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

    <Expandable title="4 эндпоинта используют эту схему"> * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

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

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

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

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

    <Expandable title="4 эндпоинта используют эту схему"> * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-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 эндпоинта используют эту схему"> - [`GET /guardrails`](/docs/api-reference/guardrails/get-list-guardrails) - [`GET /guardrails/{id}`](/docs/api-reference/guardrails/get-get-a-guardrail) - [`PATCH /guardrails/{id}`](/docs/api-reference/guardrails/patch-update-a-guardrail) - [`POST /guardrails`](/docs/api-reference/guardrails/post-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 эндпоинтов используют эту схему"> - [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) - [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) - [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) - [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-create-a-preset-from-a-messages-request-body) - [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) - [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

  • AutoRouterPlugin:

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

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

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

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

      <Expandable title="6 эндпоинтов используют эту схему"> - [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) - [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) - [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) - [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-create-a-preset-from-a-messages-request-body) - [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) - [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>
</Update>

<Update label="July 27, 2026" tags={["Embeddings","Schemas"]} rss="1 modified endpoint, 2 modified schemas.">

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

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

  • Quantization: добавлено перечисление property_added

    <Expandable title="10 эндпоинтов используют эту схему"> * [`GET /endpoints/zdr`](/docs/api-reference/endpoints/get-preview-the-impact-of-zdr-on-the-available-endpoints) * [`GET /models/{author}/{slug}/endpoints`](/docs/api-reference/endpoints/get-list-all-endpoints-for-a-model) * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /embeddings`](/docs/api-reference/embeddings/post-submit-an-embedding-request) * [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /rerank`](/docs/api-reference/rerank/post-submit-a-rerank-request) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

  • ReasoningFormat: добавлено перечисление property_added

    <Expandable title="4 эндпоинта используют эту схему"> * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>
</Update>

<Update label="July 25, 2026" tags={["BYOK","Breaking","Responses","Schemas"]} rss="2 breaking changes, 2 modified endpoints, 5 modified schemas.">

Прерывающие изменения

  • 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 и отдельная функция betaResponsesSend в TypeScript продолжают работать как устаревшие псевдонимы; их удаление будет объявлено с датой завершения до релиза.
  • $.tags: объект beta.responses удалён
    • Тот же набор изменений на уровне спецификации: определение тега beta.responses исчезло из $.tags.

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

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

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

  • ProviderName: добавлено перечисление property_added

    <Expandable title="11 эндпоинтов используют эту схему"> * [`GET /endpoints/zdr`](/docs/api-reference/endpoints/get-preview-the-impact-of-zdr-on-the-available-endpoints) * [`GET /models/{author}/{slug}/endpoints`](/docs/api-reference/endpoints/get-list-all-endpoints-for-a-model) * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /embeddings`](/docs/api-reference/embeddings/post-submit-an-embedding-request) * [`POST /images`](/docs/api-reference/images/post-generate-an-image) * [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /rerank`](/docs/api-reference/rerank/post-submit-a-rerank-request) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

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

    <Expandable title="4 эндпоинта используют эту схему"> * [`POST /audio/speech`](/docs/api-reference/tts/post-create-speech) * [`POST /audio/transcriptions`](/docs/api-reference/stt/post-create-transcription) * [`POST /images`](/docs/api-reference/images/post-generate-an-image) * [`POST /videos`](/docs/api-reference/video-generation/post-submit-a-video-generation-request) </Expandable>

  • ProviderResponse: добавлено перечисление property_added

  • BYOKProviderSlug: добавлено перечисление property_added

    <Expandable title="4 эндпоинта используют эту схему"> * [`GET /byok`](/docs/api-reference/byok/get-list-byok-provider-credentials) * [`GET /byok/{id}`](/docs/api-reference/byok/get-get-a-byok-provider-credential) * [`PATCH /byok/{id}`](/docs/api-reference/byok/patch-update-a-byok-provider-credential) * [`POST /byok`](/docs/api-reference/byok/post-create-a-byok-provider-credential) </Expandable>
</Update>

<Update label="July 24, 2026" tags={["Schemas"]} rss="8 modified schemas.">

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

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

  • ProviderName: добавлено перечисление property_added

    <Expandable title="11 эндпоинтов используют эту схему"> * [`GET /endpoints/zdr`](/docs/api-reference/endpoints/get-preview-the-impact-of-zdr-on-the-available-endpoints) * [`GET /models/{author}/{slug}/endpoints`](/docs/api-reference/endpoints/get-list-all-endpoints-for-a-model) * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /embeddings`](/docs/api-reference/embeddings/post-submit-an-embedding-request) * [`POST /images`](/docs/api-reference/images/post-generate-an-image) * [`POST /messages`](/docs/api-reference/anthropic-messages/post-create-a-message) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/messages`](/docs/api-reference/presets/post-create-a-preset-from-a-messages-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /rerank`](/docs/api-reference/rerank/post-submit-a-rerank-request) * [`POST /responses`](/docs/api-reference/responses/post-create-a-response) </Expandable>

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

    <Expandable title="4 эндпоинта используют эту схему"> * [`POST /audio/speech`](/docs/api-reference/tts/post-create-speech) * [`POST /audio/transcriptions`](/docs/api-reference/stt/post-create-transcription) * [`POST /images`](/docs/api-reference/images/post-generate-an-image) * [`POST /videos`](/docs/api-reference/video-generation/post-submit-a-video-generation-request) </Expandable>

  • ProviderResponse: добавлено перечисление 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; существующие полезные нагрузки tool_reference продолжают работать.
    • Используется в POST /messages, POST /presets/{slug}/messages

  • ORAnthropicStopReason: добавлено перечисление property_added

<Update label="July 8, 2026" tags={["Schemas"]} rss="1 new schema, 1 modified schema.">

Новые схемы

  • ImageGenTextChunkEvent

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

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

<Update label="July 7, 2026" tags={["Datasets","Images","Models","STT"]} rss="3 modified endpoints, 1 new response code, 3 new schemas, 6 modified schemas.">

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

  • 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 эндпоинта используют эту схему"> * [`POST /chat/completions`](/docs/api-reference/chat/post-create-a-chat-completion) * [`POST /presets/{slug}/chat/completions`](/docs/api-reference/presets/post-create-a-preset-from-a-chat-completions-request-body) * [`POST /presets/{slug}/responses`](/docs/api-reference/presets/post-create-a-preset-from-a-responses-request-body) * [`POST /responses`](/docs/api-reference/responses/post-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 new endpoint, 1 new schema.">

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

Новые схемы

</Update>