mirror of
https://github.com/wassname/openrouter-python-sdk-retry-errors.git
synced 2026-07-29 11:23:49 +08:00
chore: update OpenAPI spec from monorepo (#351)
Co-authored-by: OpenRouter SDK Bot <sdk-bot@openrouter.ai>
This commit is contained in:
co-authored by
OpenRouter SDK Bot
parent
678d5aacc5
commit
713dd5c71a
@@ -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 (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
|
||||
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
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user