> ## 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.

# TaskBudget

Task budget for an agentic turn. The model sees a countdown of remaining tokens and uses it to prioritize work and wind down gracefully. Advisory — does not enforce a hard cap.

## Example Usage

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

let value: TaskBudget = {
  total: 400000,
  type: "tokens",
};
```

## Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `remaining` | *number* | :heavy\_minus\_sign: | N/A |
| `total` | *number* | :heavy\_check\_mark: | N/A |
| `type` | [models.TypeTokens](../models/typetokens.mdx) | :heavy\_check\_mark: | N/A |