chore: update OpenAPI spec from monorepo (#351)

Co-authored-by: OpenRouter SDK Bot <sdk-bot@openrouter.ai>
This commit is contained in:
openrouter-docs-sync[bot]
2026-06-23 14:08:18 +00:00
committed by GitHub
co-authored by OpenRouter SDK Bot
parent 678d5aacc5
commit 713dd5c71a
+297
View File
@@ -20782,6 +20782,195 @@ components:
seed:
type: boolean
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 (01). 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 (01). 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 (01).
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 (01). 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 (01).
example: 0.52
format: double
type: number
usage_share:
description: Combined usage share of all classifications in this macro-category (01).
example: 0.45
format: double
type: number
required:
- key
- label
- usage_share
- token_share
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 (01). 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 (01). 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
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
TextConfig:
description: Text output configuration including format and verbosity
example:
@@ -24781,6 +24970,112 @@ paths:
x-speakeasy-group: chat
x-speakeasy-name-override: send
x-speakeasy-stream-request-field: stream
/classifications/task:
get:
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
summary: Task classification market share
tags:
- Classifications
/credits:
get:
description: >-
@@ -33725,6 +34020,8 @@ tags:
name: Benchmarks
- description: Chat completion endpoints
name: Chat
- description: Task classification market-share endpoints
name: Classifications
- description: Credit management endpoints
name: Credits
- description: Datasets endpoints