# Доля рынка по классификациям задач

> Возвращает распределение трафика API VEGA по классификациям задач
> (например, генерация кода, веб-поиск, суммаризация) за предшествующий временной интервал.

Для каждой классификации указывается её доля среди классифицированных выборочных запросов (`usage_share`)
и классифицированный объём выборочных токенов (`token_share`) в виде дробных значений от 0 до 1.
Неклассифицированная категория `other` исключается. Абсолютные объёмы не предоставляются,
поскольку исходные данные формируются на основе выборки.

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

Классификации сгруппированы по макрокатегориям (Code, Data, Agent, General), для каждой из которых указаны совокупные доли.

Для аутентификации используйте любой действительный ключ API VEGA (тот же ключ, который используется для инференса).
Ограничение частоты составляет 30 запросов в минуту на ключ и 500 запросов в день на аккаунт.

При публикации или цитировании этих данных указывайте источник в формате:
«Источник: API VEGA (api.vega.chat/rankings), по состоянию на {as_of}.»

## OpenAPI

```yaml /openapi/openapi.yaml get /classifications/task
openapi: 3.1.0
info:
  contact:
    email: support@openrouter.ai
    name: OpenRouter Support
    url: https://openrouter.ai/docs
  description: OpenAI-compatible API with additional OpenRouter features
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  title: OpenRouter API
  version: 1.0.0
servers:
  - description: Production server
    url: https://openrouter.ai/api/v1
    x-speakeasy-server-id: production
security:
  - apiKey: []
tags:
  - description: API key management endpoints
    name: API Keys
  - description: Analytics and usage endpoints
    name: Analytics
  - description: Anthropic Messages endpoints
    name: Anthropic Messages
  - description: BYOK endpoints
    name: BYOK
  - description: Benchmarks endpoints
    name: Benchmarks
  - description: Chat completion endpoints
    name: Chat
  - description: Task classification market-share endpoints
    name: Classifications
  - description: Credit management endpoints
    name: Credits
  - description: >-
      Public OpenRouter usage datasets. Data returned by these endpoints is
      licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/):
      reuse and republish it, including commercially, with attribution to
      OpenRouter.
    name: Datasets
  - description: Text embedding endpoints
    name: Embeddings
  - description: Endpoint information
    name: Endpoints
  - description: Files endpoints
    name: Files
  - description: Generation history endpoints
    name: Generations
  - description: Guardrails endpoints
    name: Guardrails
  - description: Images endpoints
    name: Images
  - description: Model information endpoints
    name: Models
  - description: OAuth authentication endpoints
    name: OAuth
  - description: Observability endpoints
    name: Observability
  - description: Organization endpoints
    name: Organization
  - description: Presets endpoints
    name: Presets
  - description: Provider information endpoints
    name: Providers
  - description: Rerank endpoints
    name: Rerank
  - description: OpenAI-compatible Responses API endpoints
    name: Responses
  - description: SCIM endpoints
    name: SCIM
  - description: Speech-to-text endpoints
    name: STT
    x-displayName: Transcriptions
  - description: Text-to-speech endpoints
    name: TTS
    x-displayName: Speech
  - description: Video Generation endpoints
    name: Video Generation
  - description: Workspaces endpoints
    name: Workspaces
  - description: beta.Analytics endpoints
    name: beta.Analytics
externalDocs:
  description: OpenRouter Documentation
  url: https://openrouter.ai/docs
paths:
  /classifications/task:
    get:
      tags:
        - Classifications
      summary: Task classification market share
      description: >-
        Returns the market-share breakdown of OpenRouter traffic by task
        classification

        (e.g. code generation, web search, summarization) over a trailing time
        window.

        Each classification reports its share of classified sampled requests
        (`usage_share`)

        and classified sampled token volume (`token_share`) as fractions between
        0 and 1.

        The unclassified `other` bucket is excluded. Absolute volumes are not
        exposed

        because the underlying data is sampled.

        Each classification also includes a `models` array listing the top
        models by

        request volume within that classification, with their within-tag usage
        and token shares.

        Classifications are grouped into macro-categories (Code, Data, Agent,
        General)

        with aggregate shares provided for each.

        Authenticate with any valid OpenRouter API key (same key used for
        inference).

        Rate-limited to 30 requests/minute per key and 500 requests/day per
        account.

        When republishing or quoting this data, cite as:

        "Source: OpenRouter (openrouter.ai/rankings), as of {as_of}."
      operationId: getTaskClassifications
      parameters:
        - description: >-
            Trailing time window for the classification data. Currently only
            `7d` (trailing 7 days) is supported.
          in: query
          name: window
          required: false
          schema:
            default: 7d
            description: >-
              Trailing time window for the classification data. Currently only
              `7d` (trailing 7 days) is supported.
            enum:
              - 7d
            example: 7d
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  as_of: '2026-06-17'
                  classifications:
                    - category_token_share: 0.48
                      category_usage_share: 0.51
                      display_name: Code Generation
                      macro_category: code
                      models:
                        - id: openai/gpt-4.1-mini
                          tag_token_share: 0.75
                          tag_usage_share: 0.55
                      tag: code:general_impl
                      token_share: 0.31
                      usage_share: 0.23
                  macro_categories:
                    - key: code
                      label: Code
                      token_share: 0.52
                      usage_share: 0.45
                  window_days: 7
              schema:
                $ref: '#/components/schemas/TaskClassificationResponse'
          description: >-
            Task classification market-share data for the requested trailing
            window.
        '400':
          content:
            application/json:
              example:
                error:
                  code: 400
                  message: Invalid request parameters
              schema:
                $ref: '#/components/schemas/BadRequestResponse'
          description: Bad Request - Invalid request parameters or malformed input
        '401':
          content:
            application/json:
              example:
                error:
                  code: 401
                  message: Missing Authentication header
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
          description: Unauthorized - Authentication required or invalid credentials
        '429':
          content:
            application/json:
              example:
                error:
                  code: 429
                  message: Rate limit exceeded
              schema:
                $ref: '#/components/schemas/TooManyRequestsResponse'
          description: Too Many Requests - Rate limit exceeded
        '500':
          content:
            application/json:
              example:
                error:
                  code: 500
                  message: Internal Server Error
              schema:
                $ref: '#/components/schemas/InternalServerResponse'
          description: Internal Server Error - Unexpected server error
components:
  schemas:
    TaskClassificationResponse:
      example:
        data:
          as_of: '2026-06-17'
          classifications:
            - category_token_share: 0.48
              category_usage_share: 0.51
              display_name: Code Generation
              macro_category: code
              models:
                - id: openai/gpt-4.1-mini
                  tag_token_share: 0.75
                  tag_usage_share: 0.55
              tag: code:general_impl
              token_share: 0.31
              usage_share: 0.23
          macro_categories:
            - key: code
              label: Code
              token_share: 0.52
              usage_share: 0.45
          window_days: 7
      properties:
        data:
          properties:
            as_of:
              description: >-
                UTC date (YYYY-MM-DD) of the window upper bound (yesterday).
                Data is exclusive of the current incomplete UTC day. This is the
                expected latest date in the snapshot; it does not confirm data
                presence for that date.
              example: '2026-06-17'
              type: string
            classifications:
              description: >-
                Per-task classification market-share data, sorted by usage_share
                descending.
              items:
                $ref: '#/components/schemas/TaskClassificationItem'
              type: array
            macro_categories:
              description: >-
                Aggregate market-share data per macro-category (code, data,
                agent, general).
              items:
                $ref: '#/components/schemas/TaskClassificationMacroCategory'
              type: array
            window_days:
              description: Number of trailing days covered by this snapshot.
              example: 7
              type: integer
          required:
            - window_days
            - as_of
            - classifications
            - macro_categories
          type: object
      required:
        - data
      type: object
    BadRequestResponse:
      description: Bad Request - Invalid request parameters or malformed input
      example:
        error:
          code: 400
          message: Invalid request parameters
      properties:
        error:
          $ref: '#/components/schemas/BadRequestResponseErrorData'
        openrouter_metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
        user_id:
          type:
            - string
            - 'null'
      required:
        - error
      type: object
    UnauthorizedResponse:
      description: Unauthorized - Authentication required or invalid credentials
      example:
        error:
          code: 401
          message: Missing Authentication header
      properties:
        error:
          $ref: '#/components/schemas/UnauthorizedResponseErrorData'
        openrouter_metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
        user_id:
          type:
            - string
            - 'null'
      required:
        - error
      type: object
    TooManyRequestsResponse:
      description: Too Many Requests - Rate limit exceeded
      example:
        error:
          code: 429
          message: Rate limit exceeded
      properties:
        error:
          $ref: '#/components/schemas/TooManyRequestsResponseErrorData'
        openrouter_metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
        user_id:
          type:
            - string
            - 'null'
      required:
        - error
      type: object
    InternalServerResponse:
      description: Internal Server Error - Unexpected server error
      example:
        error:
          code: 500
          message: Internal Server Error
      properties:
        error:
          $ref: '#/components/schemas/InternalServerResponseErrorData'
        openrouter_metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
        user_id:
          type:
            - string
            - 'null'
      required:
        - error
      type: object
    TaskClassificationItem:
      example:
        category_token_share: 0.48
        category_usage_share: 0.51
        display_name: Code Generation
        macro_category: code
        models:
          - id: openai/gpt-4.1-mini
            tag_token_share: 0.75
            tag_usage_share: 0.55
          - id: anthropic/claude-sonnet-4
            tag_token_share: 0.12
            tag_usage_share: 0.2
        tag: code:general_impl
        token_share: 0.31
        usage_share: 0.23
      properties:
        category_token_share:
          description: >-
            Fraction of this classification's token volume within its
            macro-category (0–1). Sums to 1 across all classifications sharing
            the same `macro_category`.
          example: 0.48
          format: double
          type: number
        category_usage_share:
          description: >-
            Fraction of this classification's usage within its macro-category
            (0–1). Sums to 1 across all classifications sharing the same
            `macro_category`.
          example: 0.51
          format: double
          type: number
        display_name:
          description: Human-readable label for the classification.
          example: Code Generation
          type: string
        macro_category:
          description: >-
            Coarse grouping derived from the tag prefix: `code`, `data`,
            `agent`, or `general`.
          example: code
          type: string
        models:
          description: >-
            Top models for this classification by request volume, sorted
            descending. Each entry reports the model's share of this
            classification's requests and tokens.
          items:
            $ref: '#/components/schemas/TaskClassificationModel'
          type: array
        tag:
          description: >-
            Classification tag identifier (e.g. `code:general_impl`,
            `agent:web_search`).
          example: code:general_impl
          type: string
        token_share:
          description: >-
            Fraction of classified sampled token volume (prompt + completion)
            attributed to this classification (0–1). The unclassified `other`
            bucket is excluded from the denominator.
          example: 0.31
          format: double
          type: number
        usage_share:
          description: >-
            Fraction of classified sampled requests attributed to this
            classification (0–1). The unclassified `other` bucket is excluded
            from the denominator.
          example: 0.23
          format: double
          type: number
      required:
        - tag
        - display_name
        - macro_category
        - usage_share
        - token_share
        - category_usage_share
        - category_token_share
        - models
      type: object
    TaskClassificationMacroCategory:
      example:
        key: code
        label: Code
        token_share: 0.52
        usage_share: 0.45
      properties:
        key:
          description: Macro-category identifier.
          example: code
          type: string
        label:
          description: Human-readable label for the macro-category.
          example: Code
          type: string
        token_share:
          description: >-
            Combined token share of all classifications in this macro-category
            (0–1).
          example: 0.52
          format: double
          type: number
        usage_share:
          description: >-
            Combined usage share of all classifications in this macro-category
            (0–1).
          example: 0.45
          format: double
          type: number
      required:
        - key
        - label
        - usage_share
        - token_share
      type: object
    BadRequestResponseErrorData:
      description: Error data for BadRequestResponse
      example:
        code: 400
        message: Invalid request parameters
      properties:
        code:
          type: integer
        message:
          type: string
        metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
      required:
        - code
        - message
      type: object
    UnauthorizedResponseErrorData:
      description: Error data for UnauthorizedResponse
      example:
        code: 401
        message: Missing Authentication header
      properties:
        code:
          type: integer
        message:
          type: string
        metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
      required:
        - code
        - message
      type: object
    TooManyRequestsResponseErrorData:
      description: Error data for TooManyRequestsResponse
      example:
        code: 429
        message: Rate limit exceeded
      properties:
        code:
          type: integer
        message:
          type: string
        metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
      required:
        - code
        - message
      type: object
    InternalServerResponseErrorData:
      description: Error data for InternalServerResponse
      example:
        code: 500
        message: Internal Server Error
      properties:
        code:
          type: integer
        message:
          type: string
        metadata:
          additionalProperties: {}
          type:
            - object
            - 'null'
      required:
        - code
        - message
      type: object
    TaskClassificationModel:
      example:
        id: openai/gpt-4.1-mini
        tag_token_share: 0.75
        tag_usage_share: 0.55
      properties:
        id:
          description: Model identifier (permaslug).
          example: openai/gpt-4.1-mini
          type: string
        tag_token_share:
          description: >-
            Fraction of this classification's sampled token volume attributed to
            this model (0–1). Sums to ≤1 across the returned models (only top-N
            are included and unattributed requests are excluded).
          example: 0.75
          format: double
          type: number
        tag_usage_share:
          description: >-
            Fraction of this classification's sampled requests attributed to
            this model (0–1). Sums to ≤1 across the returned models (only top-N
            are included and unattributed requests are excluded).
          example: 0.55
          format: double
          type: number
      required:
        - id
        - tag_usage_share
        - tag_token_share
      type: object
  securitySchemes:
    apiKey:
      description: API key as bearer token in Authorization header
      scheme: bearer
      type: http
```