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