> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TaskClassificationItem

## Example Usage

```typescript theme={null}
import { TaskClassificationItem } from "@openrouter/sdk/models";

let value: TaskClassificationItem = {
  categoryTokenShare: 0.48,
  categoryUsageShare: 0.51,
  displayName: "Code Generation",
  macroCategory: "code",
  models: [
    {
      id: "openai/gpt-4.1-mini",
      tagTokenShare: 0.75,
      tagUsageShare: 0.55,
    },
    {
      id: "anthropic/claude-sonnet-4",
      tagTokenShare: 0.12,
      tagUsageShare: 0.2,
    },
  ],
  tag: "code:general_impl",
  tokenShare: 0.31,
  usageShare: 0.23,
};
```

## Fields

| Field                | Type                                                                       | Required             | Description                                                                                                                                                                  | Example            |
| -------------------- | -------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `categoryTokenShare` | *number*                                                                   | :heavy\_check\_mark: | Fraction of this classification's token volume within its macro-category (0–1). Sums to 1 across all classifications sharing the same `macro_category`.                      | 0.48               |
| `categoryUsageShare` | *number*                                                                   | :heavy\_check\_mark: | Fraction of this classification's usage within its macro-category (0–1). Sums to 1 across all classifications sharing the same `macro_category`.                             | 0.51               |
| `displayName`        | *string*                                                                   | :heavy\_check\_mark: | Human-readable label for the classification.                                                                                                                                 | Code Generation    |
| `macroCategory`      | *string*                                                                   | :heavy\_check\_mark: | Coarse grouping derived from the tag prefix: `code`, `data`, `agent`, or `general`.                                                                                          | code               |
| `models`             | [models.TaskClassificationModel](../models/taskclassificationmodel.mdx)\[] | :heavy\_check\_mark: | Top models for this classification by request volume, sorted descending. Each entry reports the model's share of this classification's requests and tokens.                  |                    |
| `tag`                | *string*                                                                   | :heavy\_check\_mark: | Classification tag identifier (e.g. `code:general_impl`, `agent:web_search`).                                                                                                | code:general\_impl |
| `tokenShare`         | *number*                                                                   | :heavy\_check\_mark: | Fraction of classified sampled token volume (prompt + completion) attributed to this classification (0–1). The unclassified `other` bucket is excluded from the denominator. | 0.31               |
| `usageShare`         | *number*                                                                   | :heavy\_check\_mark: | Fraction of classified sampled requests attributed to this classification (0–1). The unclassified `other` bucket is excluded from the denominator.                           | 0.23               |